Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Last update 27/02/2026
Billing Reports by Orders and Packs
This endpoint allows you to obtain billing reports filtered by orders and packs.
Call:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/group/ML/order/details?order_id=$ORDER_ID
Query Parameters:
- order_ids: Allows searching by one or multiple order IDs.
- pack_id: Allows searching by a pack ID.
- sort_by:
- Possible values: ID and DATE;
- Default value: ID
- order_by: Allows sorting the search.
- Possible values: ASC, DESC;
- Default value: ASC
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/billing/integration/group/ML/order/details?order_ids=1234567899876
Response:
{
"offset": 0,
"limit": 150,
"total": 1,
"last_id": 0,
"results": [
{
"order_id": 1234567899876,
"payment_info": [
{
"payment_id": 99999999999,
"date_approved": "2026-01-14T18:41:47",
"date_created": "2026-01-14T18:41:47",
"money_release_date": "2026-01-17T17:08:19",
"money_release_days": 28,
"money_release_status": "released",
"payer_id": 12345678,
"payment_method_id": "account_money",
"payment_type_id": "account_money",
"status": "approved",
"status_details": null,
"base_amount": 450.49,
"base_amount_usd": 25.19,
"tax_details": [
{
"from": "collector",
"to": "9999999991",
"original_amount": 72.08,
"original_amount_usd": 4.03,
"refunded_amount": 0,
"refunded_amount_usd": 0,
"mov_detail": "tax_withholding",
"mov_financial_entity": "iva",
"tax_id": null,
"tax_status": "applied"
},
{
"from": "collector",
"to": "9999999992",
"original_amount": 90.1,
"original_amount_usd": 5.04,
"refunded_amount": 0,
"refunded_amount_usd": 0,
"mov_detail": "tax_withholding",
"mov_financial_entity": "isr",
"tax_id": null,
"tax_status": "applied"
}
]
}
],
"sale_fee": null,
"details": [
{
"charge_info": {
"legal_document_number": "0011A03800000",
"legal_document_status": "PROCESSED",
"legal_document_status_description": "Processed",
"creation_date_time": "2026-01-14T12:42:28",
"detail_id": 5555566666,
"transaction_detail": "Service fee",
"debited_from_operation": "YES",
"debited_from_operation_description": "Yes",
"status": null,
"status_description": null,
"charge_bonified_id": null,
"detail_amount": 0.53,
"detail_type": "CHARGE",
"detail_sub_type": "CVMPI"
},
"discount_info": {
"charge_amount_without_discount": 0.53,
"discount_amount": 0.0,
"discount_reason": null,
"rebate": null
},
"sales_info": [
{
"order_id": 1234567899876,
"operation_id": 99999999999,
"sale_date_time": "2026-01-14T14:41:46",
"sales_channel": "Mercado Libre",
"payer_nickname": "NICKNAME",
"state_name": "Nuevo León",
"transaction_amount": 522.57,
"transaction_amount_usd": 29.21
}
],
"shipping_info": {
"shipping_id": "5555566666",
"pack_id": "2000011040970000",
"receiver_shipping_cost": 0
},
"items_info": [
{
"item_id": "MLM920316309",
"item_kit_id": null,
"item_title": "Tenis De Seguridad Industrial Zapatos Impermeables Hombre",
"item_type": "gold_special",
"item_category": "Industrias y Oficinas > Seguridad Laboral > Protección Personal > Calzado Industrial",
"inventory_id": null,
"item_amount": 1,
"item_price": 522.57,
"item_price_usd": 29.21,
"order_id": 1234567899876
}
],
"document_info": {
"document_id": 5555566666
},
"marketplace_info": {
"marketplace": "CORE"
},
"currency_info": {
"currency_id": "USD"
}
}
]
}
]
}
Response Parameters
- offset: Starting position of the results.
- limit: Maximum number of results per page.
- total: Total number of results found.
- last_id: Identifier of the last returned result (used for pagination).
- order_id: Sale identifier.
- payment_info: Payment information.
- payment_id: Payment identifier.
- date_approved: Approval date.
- date_created: Creation date.
- money_release_date: Payment release date.
- money_release_days: Days until payment release.
- money_release_status: Payment release status.
- payer_id: Customer identifier.
- payment_method_id: Payment method.
- payment_type_id: Payment method type.
- status: Payment status.
- status_details: Payment status details.
- base_amount: Taxable base amount in local currency. Available for both CBT and non-CBT users.
- base_amount_usd: Taxable base amount in USD. Only returned for CBT (Cross-Border Trade) users.
- tax_details: Tax details.
- from: Origin of the tax movement.
- to: Destination identifier of the tax movement.
- original_amount: Tax withholding amount in local currency.
- original_amount_usd: Tax withholding amount in USD. Only returned for CBT (Cross-Border Trade) users.
- refunded_amount: Tax refund amount in local currency.
- refunded_amount_usd: Tax refund amount in USD. Only returned for CBT (Cross-Border Trade) users.
- mov_detail: Tax movement type.
- mov_financial_entity: Financial entity associated with the tax.
- tax_id: Tax identifier (may be null).
- tax_status: Tax application status.
- sale_fee: Sale fee information (Exclusive to Brazil). May be null if not applicable.
- gross: Charge amount without discount.
- net: Charge amount.
- rebate: Discount amount for participation in a commercial campaign.
- discount: Discount amount.
- discount_reason: Discount reason.
- details: Charge details.
- charge_info: Charge information.
- legal_document_number: Legal document number.
- legal_document_status: Legal document processing status.
- legal_document_status_description: Human-readable description of the document status.
- creation_date_time: Charge creation date and time.
- detail_id: Charge detail identifier.
- transaction_detail: Description of the charge type.
- debited_from_operation: Whether the charge was debited from the operation.
- debited_from_operation_description: Human-readable description.
- status: Charge status.
- status_description: Charge status description.
- charge_bonified_id: Bonified charge identifier (if applicable).
- detail_amount: Charge amount in the currency specified by currency_info.
- detail_type: Charge type.
- detail_sub_type: Charge subtype.
- discount_info: Discount information.
- charge_amount_without_discount: Charge amount before discounts, in the currency specified by currency_info.
- discount_amount: Discount amount, in the currency specified by currency_info.
- discount_reason: Discount reason.
- rebate: Rebate amount (if applicable).
- sales_info: Sale information.
- order_id: Sale identifier.
- operation_id: Operation identifier.
- sale_date_time: Sale date and time.
- sales_channel: Sales channel.
- payer_nickname: Buyer nickname.
- state_name: Buyer's state/province.
- transaction_amount: Transaction amount in local currency.
- transaction_amount_usd: Transaction amount in USD. Only returned for CBT (Cross-Border Trade) users.
- shipping_info: Shipping information.
- shipping_id: Shipment identifier.
- pack_id: Pack identifier (if applicable).
- receiver_shipping_cost: Shipping cost charged to the buyer.
- items_info: Listing information.
- item_id: Item identifier.
- item_kit_id: Kit identifier (if the item belongs to a kit).
- item_title: Item title.
- item_type: Item listing type.
- item_category: Item category path.
- inventory_id: Inventory identifier.
- item_amount: Quantity of items sold.
- item_price: Item price in local currency.
- item_price_usd: Item price in USD. Only returned for CBT (Cross-Border Trade) users.
- order_id: Sale identifier.
- document_info: Document information.
- document_id: Document identifier.
- marketplace_info: Marketplace information.
- marketplace: Marketplace where the charge originated.
- currency_info: Currency information.
- currency_id: Currency used for charge_info and discount_info amounts.
- charge_info: Charge information.