Billing data

Query billing data

To get the information about a buyer's billing data contained in an order, make the following call. Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/orders/$ORDER_ID/billing_info

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/1691789796/billing_info

The orders from Mercado Libre Argentina and Brazil returns billing data by:

• Products with Fullfillment or CrossDocking
• Products from Tiendas Oficiales, Mercado Lideres.
• Products with Global Selling.
• Purchases con Garex.

Response (these are examples of persons: MLB and MLA Individual/Legal Entity) MLA - Individual
Order Id: 1691789796
User id: 316440831

{
  "billing_info": {
    "additional_info": [
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STREET_NUMBER",
        "value": "3571"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "LAST_NAME",
        "value": "Gomez Blanco"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_NUMBER",
        "value": "32659430"
      },
      {
        "type": "DOC_TYPE",
        "value": "DNI"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "FIRST_NAME",
        "value": "María Lupita"
      },
      {
        "type": "NEIGHBORHOOD",
        "value": "Divino"
      }
    ],
    "doc_number": "32659430",
    "doc_type": "DNI"
  }
}

{
  "billing_info": {
    "additional_info": [
      {
        "type": "DOC_NUMBER",
        "value": "30703088534"
      },
      {
        "type": "ZIP_CODE",
        "value": "1430"
      },
      {
        "type": "STATE_REGISTRATION",
        "value": "30703088534"
      },
      {
        "type": "TAXPAYER_TYPE_ID",
        "value": "IVA Responsable Inscripto"
      },
      {
        "type": "BUSINESS_NAME",
        "value": "Mercado Libre S.R.L"
      },
      {
        "type": "CITY_NAME",
        "value": "Saavedra"
      },
      {
        "type": "STREET_NAME",
        "value": "Arias"
      },
      {
        "type": "STREET_NUMBER",
        "value": "SN"
      },
      {
        "type": "COMMENT",
        "value": "7b"
      },
      {
        "type": "DOC_TYPE",
        "value": "CUIT"
      },
      {
        "type": "STATE_NAME",
        "value": "Capital Federal"
      },
      {
        "type": "SITE_ID",
        "value": "MLA"
      },
{
type: "NEIGHBORHOOD",
value: "Divino"
},
    ],

    "doc_number": "30703088534",
    "doc_type": "CUIT"
  }
}

Types and values for additional_info

These are the possibles types and values (type / value) for additional_info.

Individual Entity

• first_name: buyer's name
• last_name: buyer's last name
• doc_type: document type
• doc_number: document number
• zip_code: buyer zip code
• street_name: buyer's address
• street_number: buyer address number

Can be "SN" for street cases without number

• comment: extra comment about buyer's address
• state_name: buyer's status
• city_name: buyer's city
• secondary_doc_type : additional document type (only for MLA)
• secondary_doc_number: additional document number (only for MLA)

Legal Entity

Possible values: between "monotax" (non-VAT taxpayer) and "VAT"

To MLA:
-Monotributo
-IVA Responsable Inscripto
-IVA Exento

To MLB:
-Contribuinte
-Não contribuinte

Possible values: any string, "SN" for street without number

DOC_TYPE's

Argentina (MLA): DNI, CUIT.

Brasil (MLB): CPF, CNPJ.

Chile (MLC): RUT.

Colombia (MCO): CC, CE, NIT.

Venezuela (MLV): CI, RIF, Passport.

Uruguay (MLU): CI, RUT.

Perú (MPE): DNI, CE.