# Fulfillment.com APIv2 API

> Fulfillment.com APIv2 API on Apizie: 13 endpoints (List Order Accounting, List of Item Inventories, Generate an Access Token, List of Orders, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/ecommerce:fulfillment/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:fulfillment`
- Category: E-commerce
- Status: byok
- Source: https://fulfillment.com
- Page: https://www.apizie.tech/api/ecommerce/fulfillment
- OpenAPI: https://www.apizie.tech/api/ecommerce/fulfillment/openapi.json

Welcome to our current iteration of our REST API. While we encourage you to upgrade to v2.0 we will continue support for our [SOAP API](https://github.com/fulfillment/soap-integration). # Versioning The Fulfillment.com…

## Endpoints

### List Order Accounting
`GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-accounting` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fromDate | string | yes | Orders invoice date. Date-time in ISO 8601 format for selecting orders after, or at, the specified time |
| toDate | string | yes | Orders invoice date. Date-time in ISO 8601 format for selecting orders before, or at, the specified time |
| page | integer | no | A multiplier of the number of items (limit parameter) to skip before returning results |
| limit | integer | no | The numbers of items to return |
| warehouseIds | array | no | A CSV of warehouse id, '123' or '1,2,3' |
| orderIds | array | no | A CSV of FDC order id, '123' or '1,2,3' |
| hydrate | array | yes | Adds additional information to the response, uses a CSV format for multiple values. |

### List of Item Inventories
`GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-inventory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | A multiplier of the number of items (limit parameter) to skip before returning results |
| limit | integer | no | The numbers of items to return |
| merchantIds | array | no | A CSV of merchant id, '123' or '1,2,3' |
| warehouseIds | array | no | A CSV of warehouse id, '123' or '1,2,3' |
| externalSkuNames | array | no | A CSV of sku reference names, 'skuName1' or 'skuName1,skuName2,skuName3' |

### Generate an Access Token
`POST https://www.apizie.tech/v1/ecommerce:fulfillment/post-oauth-access-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### List of Orders
`GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fromDate | string | yes | Date-time in ISO 8601 format for selecting orders after, or at, the specified time |
| toDate | string | yes | Date-time in ISO 8601 format for selecting orders before, or at, the specified time |
| merchantIds | array | no | A CSV of merchant id, '123' or '1,2,3' |
| warehouseIds | array | no | A CSV of warehouse id, '123' or '1,2,3' |
| page | integer | no | A multiplier of the number of items (limit parameter) to skip before returning results |
| limit | integer | no | The numbers of items to return |
| hydrate | array | no | Adds additional information to the response, uses a CSV format for multiple values.' |

### New Order
`POST https://www.apizie.tech/v1/ecommerce:fulfillment/post-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Order Details
`GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The FDC order Id |
| merchantId | integer | no | Providing your `merchantId` indicates the `id` is your `merchantOrderId`. Although it is not necessary to provide this it will speed up… |
| hydrate | array | no | Adds additional information to the response, uses a CSV format for multiple values.' |

### Cancel an Order
`POST https://www.apizie.tech/v1/ecommerce:fulfillment/delete-orders-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | ID of order that needs to be canceled |

### Ship an Order
`POST https://www.apizie.tech/v1/ecommerce:fulfillment/put-orders-id-ship` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | The FDC order Id |
| body | object | yes | JSON request body |

### Update Order Status
`POST https://www.apizie.tech/v1/ecommerce:fulfillment/put-orders-id-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | The FDC order Id |
| body | object | yes | JSON request body |

### List Returns
`GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-returns` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| fromDate | string | yes | Date-time in ISO 8601 format for selecting orders after, or at, the specified time |
| toDate | string | yes | Date-time in ISO 8601 format for selecting orders before, or at, the specified time |
| page | integer | no | A multiplier of the number of items (limit parameter) to skip before returning results |
| limit | integer | no | The numbers of items to return |

### Inform us of an RMA
`POST https://www.apizie.tech/v1/ecommerce:fulfillment/put-returns` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Tracking
`GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-track` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| trackingNumber | string | no |  |

### About Me
`GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-users-me` (byok)

## Example
```
curl "https://www.apizie.tech/v1/ecommerce:fulfillment/get-accounting" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Fulfillment.com APIv2 API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/ecommerce:fulfillment/get-accounting with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Fulfillment.com APIv2 API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Fulfillment.com APIv2 itself also needs your own key from fulfillment.com.

### Can AI agents use the Fulfillment.com APIv2 API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:fulfillment.

### What is the status of the Fulfillment.com APIv2 API?
Needs your own provider key (bring your own key)