ImportYeti
PowerQuery
GET

Get one Mexico import declaration

0.1 per BOL

Fetch a single Mexico import declaration by declaration_id. Costs 0.1 data credits.

Parameters#

Path parameters

  • declarationIdstringrequired

    Declaration identifier

Query parameters

  • fieldsstringoptional

    Comma-separated list of fields to keep on each returned record, e.g. bol_number,arrival_date,supplier_name. Everything else is omitted. Names that the record does not carry are ignored. The envelope (requestCost, creditsRemaining, executionTime, totalCount) is always returned in full. Cannot be combined with exclude. Omit for the full record.

  • excludestringoptional

    Comma-separated list of fields to drop from each returned record, e.g. containers,shipping_rate. Every other field is kept. Cannot be combined with fields. Omit for the full record.

  • formatstringoptionaldefault json

    Response encoding. Defaults to json. Pass toon to receive TOON — the same data in a compact, token-efficient text form intended for LLM prompts. Error responses are always JSON.

    one ofjsontoon

fields, exclude, and format work the same way on every endpoint — Response shaping has worked examples.

Response#

One Mexico import customs declaration.

Response shape
{
  "requestCost": 0.1,
  "creditsRemaining": 9998.5,
  "data": {
    "data": [
      {
        "declaration_id": "6002927-3f1ea4a7c5795cb4a3738fb7dd63c262",
        "declaration_number": "6002927",
        "rfc_number": "TME840710TR4",
        "pedimento_number": "26_17_TME840710TR4_6002927",
        "export_date": "02/28/2026",
        "company_name": "Ternium Mexico Sa De Cv",
        "company_state": "Nuevo Leon",
        "company_country": "Mexico"
        // …25 more fields
      }
    ],
    "totalCount": 59583
  },
  "executionTime": "224ms"
}

Rows are nested one level deeper

PowerQuery routes put the records at data.data — not at data. The total number of matches is on data.totalCount, which is the value you page against. Note that this key is named per route family (totalCount, totalCompanies, totalSuppliers, totalBrokers).

Top-level fields#

  • data — an object holding the result rows (data.data) and the match total (data.totalCount)
  • requestCost — Data credits used for this call (0 if none)
  • creditsRemaining — Your data credit balance after the call
  • executionTime — How long the request took
  • totalCount — Total matching records, not just this page

Fields on each row in data.data#

FieldExample
33 fields
  • declaration_idstring6002927-3f1ea4a7c5795cb4a3738fb7dd63c262
  • declaration_numberstring6002927
  • rfc_numberstringTME840710TR4

    Registro Federal de Contribuyentes — the Mexican tax ID of the filing company.

  • pedimento_numberstring26_17_TME840710TR4_6002927

    Line-level pedimento identifier, combining year, customs office, RFC, and declaration number.

  • export_datestring02/28/2026
  • company_namestringTernium Mexico Sa De Cv
  • company_statestringNuevo Leon
  • company_countrystringMexico
  • company_country_codestringMX
  • company_total_shipmentsnumber83355

  • Company address geocode object

    address_components, formatted_address, location

  • supplier_namestringTransamerica E And I Trading Corporation

Errors#

Failures come back as JSON with a statusCode and message. The ones worth handling here are 401 (bad or missing key), 403 (out of credits), and 404 (no such record). See all error responses.