Get Services Trade Data
comtrade_get_services_tradeRead-only
Fetch international trade-in-services data (EBOPS 2010 classification). Same bilateral structure as goods trade: returns flow value in USD, period, and reporter/partner/category metadata for each row. Use comtrade_list_service_categories to find the right service code before querying. Preview makes one paced request per served period, capped at 500 records per request. Services coverage is more limited than goods trade.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| period | Yes | Periods (YYYY or YYYYMM). Serves the first 12 and discloses the remainder; input ceiling 120. Preview makes one paced request per period. | |
| flow_code | Yes | Trade flow: M=imports (credit received by reporter), X=exports (debit paid). | |
| partner_code | No | M49 partner code. Use 0 for all partners combined. Omit for a disaggregated by-partner breakdown. | |
| service_code | No | EBOPS 2010 service category code (e.g. "SA" for transport). Use comtrade_list_service_categories to find available codes. Omit to get totals across all service categories. | |
| reporter_code | Yes | M49 numeric code of the reporting country. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of records returned. | |
| notice | No | Recovery hint when no records are returned. | |
| records | No | Services trade flow records. | |
| truncated | No | True when any preview response reached 500 and may be incomplete. | |
| totalCount | No | Sum of upstream response counts before local filtering; not a full match count when capped. | |
| truncationHint | No | Query narrowing and authenticated access guidance when possibly incomplete. | |
| unservedPeriods | No | Periods beyond the 12-period work cap; query them separately. |