ImportYeti
PowerQuery
GET

Search Mexico import declarations

1 per 10 records

PowerQuery over Mexico import customs declarations (pedimentos).

Parameters#

Query parameters

27 parameters
  • page_sizenumberoptionaldefault 10

    Number of returned results

  • offsetnumberoptionaldefault 0

    Results starting position

  • start_datestringoptionaldefault 01/01/2021
  • end_datestringoptionaldefault 08/31/2026
  • pagenumberoptional

    Page number (1-indexed). Takes precedence over offset.

  • company_namestringoptional
  • supplier_namestringoptional
  • product_descriptionstringoptional

    Supports boolean operators and wildcards

    AND / OR / NOTwildcards * ?
  • weightstringoptional

    Supports ranges

    ranges [a TO b]
  • company_total_shipmentsstringoptional

    Supports ranges

    ranges [a TO b]
  • supplier_total_shipmentsstringoptional

    Supports ranges

    ranges [a TO b]
  • who_pays_freightstringoptionaldefault Foreign entity

    Foreign entity / Mexico entity

    one ofForeign entityMexico entity

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

Response#

A page of matching Mexico import customs declarations.

Response shape
{
  "requestCost": 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.