--- type: "firecrawl-provider" description: "U.S. Customs and Border Protection's Withhold Release Orders (WRO) and Findings dataset (forced-labor detention and seizure orders under 19 U.S.C. 1307) from the CBP Public Data Portal: the current dated CSV resolved from the dataset page on every call, with a version check, a full paginated list and a lookup by derived id." use_when: "U.S. Customs and Border Protection's Withhold Release Orders (WRO) and Findings dataset (forced-labor detention and seizure orders under 19 U.S.C. 1307) from the CBP Public Data Portal: the current dated CSV resolved from the dataset page on every call, with a version check, a full paginated list and a lookup by derived id." categories: "Public records" capabilities: 3 credits_per_call: 5 --- # CBP Withhold Release Orders and Findings on Firecrawl Alexandria U.S. Customs and Border Protection's Withhold Release Orders (WRO) and Findings dataset (forced-labor detention and seizure orders under 19 U.S.C. 1307) from the CBP Public Data Portal: the current dated CSV resolved from the dataset page on every call, with a version check, a full paginated list and a lookup by derived id. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `cbp-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/cbp-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/cbp-gov/openapi.json) ## Capabilities - [Records get](https://firecrawl.dev/alexandria/agents/providers/cbp-gov/withhold-release-orders/records_get): One WRO or Finding by its derived `source_record_id` (`wro:` + 16 hex characters, as returned by records_list). Fetches the current CSV and returns the matching row; an id that is not in the current publication is `not_found` (revoked orders drop out of the file). - [Records list](https://firecrawl.dev/alexandria/agents/providers/cbp-gov/withhold-release-orders/records_list): The full current WRO and Findings list in file order (chronological), paginated by offset with a cursor pinned to one publication (CSV URL plus SHA-256). Every page re-resolves the CSV from the dataset page and re-fetches it; if the publication moved since the cursor was issued the call fails with `invalid_input` and issue code `publication_changed` instead of mixing versions. Filters narrow the list; pass the same filters with the cursor. No `records/changes`: CBP publishes no deltas, and revoked orders drop out of the file rather than change status, so keep history by diffing snapshots. - [Source status](https://firecrawl.dev/alexandria/agents/providers/cbp-gov/withhold-release-orders/source_status): Cheap version check of the WRO and Findings dataset: resolves the current dated CSV from the dataset page (the filename changes with every update), returns its URL, the page's `Last Modified` date, the file's HTTP Last-Modified and ETag, byte size, SHA-256 of the raw bytes, the column names and the row count. ## 1. Choose this provider when U.S. Customs and Border Protection's Withhold Release Orders (WRO) and Findings dataset (forced-labor detention and seizure orders under 19 U.S.C. 1307) from the CBP Public Data Portal: the current dated CSV resolved from the dataset page on every call, with a version check, a full paginated list and a lookup by derived id. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "cbp-gov", "capability": "withhold-release-orders/records_get", "options": { "source_record_id": "wro:fb8517a6b2dd9c43" } } ``` ## 3. Add provider options Use only the options needed for the task: - `source_record_id` (string, required): Derived id from records_list, e.g. `wro:fb8517a6b2dd9c43`. Pattern: ^wro:[0-9a-f]{16}$. Example: `wro:fb8517a6b2dd9c43` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "cbp-gov", capability: "withhold-release-orders/records_get", options: { source_record_id: "wro:fb8517a6b2dd9c43", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "cbp-gov", "capability": "withhold-release-orders/records_get", "options": { "source_record_id": "wro:fb8517a6b2dd9c43" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "cbp-gov", "capability": "withhold-release-orders/records_get", "options": { "source_record_id": "wro:fb8517a6b2dd9c43" } } }' ``` ### CLI ```sh firecrawl scrape 'cbp-gov/withhold-release-orders/records_get' \ --options '{"source_record_id":"wro:fb8517a6b2dd9c43"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "cbp-gov", "capability": "withhold-release-orders/records_get", "options": { "source_record_id": "wro:fb8517a6b2dd9c43" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "cbp-gov", "capability": "withhold-release-orders/records_get", "options": { "source_record_id": "wro:fb8517a6b2dd9c43" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "observed_at_ms": 1792302895606, "record": { "aliases": [], "calendar_year": 1953, "country": "Mexico", "country_code": "MX", "effective_date": "1953-12-28", "industry": "Consumer Products and Mass Merchandising", "manufacturer": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "notice_url": null, "order_type": "Finding", "publication_id": "withhold-release-orders-findings-fy26-2026-09-29.csv", "raw": { "effective_date": "12/28/1953", "entity": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "order_type": "Finding" }, "remarks": "\"Customs,\" Treasury Decisions. U.S. Treasury Department 88 (1953): 416; T.D. 53408", "retrieved_at": "2026-10-18T05:54:55Z", "source_record_id": "wro:fb8517a6b2dd9c43", "source_url": "https://www.cbp.gov/sites/default/files/2026-09/withhold-release-orders-findings-fy26-2026-09-29.csv", "status": "Active" } } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Records get - Capability: `withhold-release-orders/records_get` - Description: One WRO or Finding by its derived `source_record_id` (`wro:` + 16 hex characters, as returned by records_list). Fetches the current CSV and returns the matching row; an id that is not in the current publication is `not_found` (revoked orders drop out of the file). - Instructions: Re-read one order by the id a previous records_list returned. - Cost: 5 credits per call - Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/cbp-gov/withhold-release-orders/records_get) Accepted options: - `source_record_id` (string, required): Derived id from records_list, e.g. `wro:fb8517a6b2dd9c43`. Pattern: ^wro:[0-9a-f]{16}$. Example: `wro:fb8517a6b2dd9c43` Response schema example: ```json { "observed_at_ms": 1792302895606, "record": { "aliases": [], "calendar_year": 1953, "country": "Mexico", "country_code": "MX", "effective_date": "1953-12-28", "industry": "Consumer Products and Mass Merchandising", "manufacturer": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "notice_url": null, "order_type": "Finding", "publication_id": "withhold-release-orders-findings-fy26-2026-09-29.csv", "raw": { "effective_date": "12/28/1953", "entity": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "order_type": "Finding" }, "remarks": "\"Customs,\" Treasury Decisions. U.S. Treasury Department 88 (1953): 416; T.D. 53408", "retrieved_at": "2026-10-18T05:54:55Z", "source_record_id": "wro:fb8517a6b2dd9c43", "source_url": "https://www.cbp.gov/sites/default/files/2026-09/withhold-release-orders-findings-fy26-2026-09-29.csv", "status": "Active" } } ``` ### Records list - Capability: `withhold-release-orders/records_list` - Description: The full current WRO and Findings list in file order (chronological), paginated by offset with a cursor pinned to one publication (CSV URL plus SHA-256). Every page re-resolves the CSV from the dataset page and re-fetches it; if the publication moved since the cursor was issued the call fails with `invalid_input` and issue code `publication_changed` instead of mixing versions. Filters narrow the list; pass the same filters with the cursor. No `records/changes`: CBP publishes no deltas, and revoked orders drop out of the file rather than change status, so keep history by diffing snapshots. - Instructions: Collect every order, or filter by order type, status, country, industry or year. Start without a cursor; follow `next_cursor` until it is null. - Cost: 5 credits per call - Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/cbp-gov/withhold-release-orders/records_list) Accepted options: - `country_code` (string): Keep only this `Country Code` (ISO alpha-2, or `FV` for fishing vessels). Pattern: ^[A-Za-z]{2}$. Example: `Country Code` - `cursor` (string): Opaque continuation from a previous page's `next_cursor`. Pinned to the CSV URL and SHA-256 it was issued for; a moved publication fails with issue code `publication_changed`. Example: `next_cursor` - `industry` (string): Keep only rows whose `Industry` equals this value, case-insensitively. Example: `` - `limit` (number): Rows per page (the whole file is about 70 rows). Example: `100` - `order_type` (string): Keep only this `WRO/Finding` value. Example: `WRO` - `query` (string): Case-insensitive substring match over entity, merchandise, country and remarks. Example: `` - `status` (string): Keep only rows whose `Status` equals this value, case-insensitively (`Active`, `Partially Modified`, `Inactive-Pending Litigation`). Example: `` - `year` (number): Keep only rows with this `Calendar Year`. Example: `1900` Response schema example: ```json { "next_cursor": null, "observed_at_ms": 1792302892156, "offset": 0, "publication_id": "withhold-release-orders-findings-fy26-2026-09-29.csv", "records": [ { "aliases": [], "calendar_year": 1953, "country": "Mexico", "country_code": "MX", "effective_date": "1953-12-28", "industry": "Consumer Products and Mass Merchandising", "manufacturer": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "notice_url": null, "order_type": "Finding", "publication_id": "withhold-release-orders-findings-fy26-2026-09-29.csv", "raw": { "effective_date": "12/28/1953", "entity": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "order_type": "Finding" }, "remarks": "\"Customs,\" Treasury Decisions. U.S. Treasury Department 88 (1953): 416; T.D. 53408", "retrieved_at": "2026-10-18T05:54:52Z", "source_record_id": "wro:fb8517a6b2dd9c43", "source_url": "https://www.cbp.gov/sites/default/files/2026-09/withhold-release-orders-findings-fy26-2026-09-29.csv", "status": "Active" }, { "aliases": [], "calendar_year": 1958, "country": "Mexico", "country_code": "MX", "effective_date": "1958-10-29", "industry": "Consumer Products and Mass Merchandising", "manufacturer": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "notice_url": null, "order_type": "Finding", "publication_id": "withhold-release-orders-findings-fy26-2026-09-29.csv", "raw": { "effective_date": "10/29/1958", "entity": "State Penitentiary, Ciudad Victoria, Tamaulipas, Mexico", "merchandise": "Furniture", "order_type": "Finding" }, "remarks": "\"Customs,\" Treasury Decisions. U.S. Treasury Department 93 (1958): 517-518; T.D. 54725", "retrieved_at": "2026-10-18T05:54:52Z", "source_record_id": "wro:51384765c5daac5e", "source_url": "https://www.cbp.gov/sites/default/files/2026-09/withhold-release-orders-findings-fy26-2026-09-29.csv", "status": "Active" } ], "retrieved_at": "2026-10-18T05:54:52Z", "sha256": "ab09d08aa55f418fc1b0fffd3ac7e54ab09ea8325e778e88f4835c6d9b20ceae", "source_url": "https://www.cbp.gov/sites/default/files/2026-09/withhold-release-orders-findings-fy26-2026-09-29.csv", "total": 2 } ``` ### Source status - Capability: `withhold-release-orders/source_status` - Description: Cheap version check of the WRO and Findings dataset: resolves the current dated CSV from the dataset page (the filename changes with every update), returns its URL, the page's `Last Modified` date, the file's HTTP Last-Modified and ETag, byte size, SHA-256 of the raw bytes, the column names and the row count. - Instructions: Call first to learn whether the publication moved (compare `publication_id` or `sha256` with the last snapshot) before listing records. - Cost: 5 credits per call - Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/cbp-gov/withhold-release-orders/source_status) Accepted options: Response schema example: ```json { "columns": [ "Effective Date", "Calendar Year", "Country Code", "Country", "Merchandise", "WRO/Finding", "Industry", "Status", "Press Release", "Entity", "Remarks" ], "data_dictionary_url": "https://www.cbp.gov/sites/default/files/2025-07/wro-finding_dashboard_data_dictionary.pdf", "dataset_url": "https://www.cbp.gov/document/stats/withhold-release-orders-findings", "etag": "\"4810-65ca152ecfd28\"", "file_last_modified": "Tue, 29 Sep 2026 16:03:31 GMT", "file_url": "https://www.cbp.gov/sites/default/files/2026-09/withhold-release-orders-findings-fy26-2026-09-29.csv", "observed_at_ms": 1792302886219, "page_last_modified": "Sep 29, 2026", "publication_id": "withhold-release-orders-findings-fy26-2026-09-29.csv", "published_at": "2026-09-29", "record_count": 69, "retrieved_at": "2026-10-18T05:54:46Z", "sha256": "ab09d08aa55f418fc1b0fffd3ac7e54ab09ea8325e778e88f4835c6d9b20ceae", "size_bytes": 18448 } ```