Fulfillment.com APIv2

Name: Fulfillment.com APIv2 API
Brand: Fulfillment.com APIv2
Availability: InStock

✓ Official Vendor SpecE CommerceShipping Logisticsoauth2, apiKey15 EndpointsREST

For Agents

Submit and track ecommerce orders through the Fulfillment.com warehouse network, manage returns, and read inventory and accounting data.

Connect the Fulfillment.com APIv2 to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Fulfillment.com APIv2, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Fulfillment.com APIv2 API.

Submit a new order to the Fulfillment.com warehouse network for pick, pack, and ship

Update an existing order's status or cancel it before dispatch

Track an order through the FDC fulfilment lifecycle using documented status codes

List and update returns processed against the merchant account

GET STARTED

Start building with Fulfillment.com APIv2 API

Explore with Jentic

View OpenAPI Document

Fulfillment.com (FDC) is a 4PL fulfilment provider whose v2 REST API lets merchants submit and track orders, manage returns, query inventory, and reconcile accounting from their warehouse network. The API exposes 15 endpoints covering orders, returns, tracking, inventory, accounting, and a simple OAuth2 access-token flow. Status codes are six digits and are documented in the spec to track an order from received through shipped to returned. Authentication uses OAuth2 bearer tokens and an x-api-key header.

Use Cases

Patterns agents use Fulfillment.com APIv2 API for, with concrete tasks.

★ Direct-to-Consumer Order Submission

When a Shopify or custom storefront takes an order, an integration calls POST /orders on the FDC API with the order line items, ship-to address, and merchant order ID. FDC validates the address, allocates inventory, and returns an FDC order ID. Subsequent calls to GET /orders/{id} return a six-digit status code that maps the order through processing, fulfilment, and shipped.

Create an FDC order with merchantOrderId 'WEB-123', one SKU at quantity 2, and a US ship-to address

Returns Reconciliation

When a customer initiates a return, FDC records it under /returns. A reconciliation script calls GET /returns daily to pull the latest entries and PUT /returns to update merchant-side disposition. This keeps the merchant order management system aligned with what FDC has physically received.

Call GET /returns for the last 7 days and update each return's disposition via PUT /returns

Inventory Visibility

Before allowing checkout on a SKU, the storefront calls GET /inventory to confirm units are available. For low-frequency dashboards, GET /inventory/full pulls the entire merchant inventory snapshot. Combined with order status this gives the merchant a real-time view of stock and fulfilment posture across FDC facilities.

Call GET /inventory for SKU ABC-001 and return current available units

Tracking and Status Updates

Once an order is shipped, GET /track returns carrier tracking metadata and PUT /orders/{id}/ship updates the order to shipped state with departDate. The combination of status codes and tracking lets the merchant power 'where is my order?' surfaces and customer notifications.

Call GET /track for order id 12345 and return the carrier and tracking number

Agent-Driven Fulfilment Operations

An AI agent fields a merchant question like 'what's the status of order WEB-123?' and resolves the FDC order ID, fetches /orders/{id}, /track, and any returns. With Jentic the OAuth2 flow happens behind the scenes — the agent gets a scoped result and never handles the client_secret.

Search Jentic for 'check fulfillment order status', load GET /orders/{id}, and execute against the merchant order ID

Key Endpoints

15 endpoints — fulfillment.

METHOD

PATH

DESCRIPTION

POST

/orders

Submit a new order to FDC

GET

/orders/{id}

Retrieve order status and details

PUT

/orders/{id}/status

Update an order's status

PUT

/orders/{id}/ship

Mark an order as shipped

GET

/track

Retrieve carrier tracking metadata

GET

/inventory

Query current inventory levels

POST

/oauth/access_token

Generate or refresh an OAuth2 access token

POST

/orders

Submit a new order to FDC

GET

/orders/{id}

Retrieve order status and details

PUT

/orders/{id}/status

Update an order's status

PUT

/orders/{id}/ship

Mark an order as shipped

GET

/track

Retrieve carrier tracking metadata

GET

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Fulfillment.com client_id, client_secret, and x-api-key are stored encrypted in the Jentic MAXsystem vault. The OAuth2 token exchange runs inside Jentic at execution time, so the agent never sees the long-lived secret or the rotated access_token.

Intent-based discovery

Agents search Jentic for intents like 'submit a fulfillment order' or 'track a fulfillment order' and Jentic returns the matching POST /orders or GET /track operation with its input schema, so the agent does not have to study the FDC status-code table to make the right call.

Time to first call

Direct FDC integration: 3-5 days for OAuth2 flow, order shape, status-code mapping, and webhook-style polling. Through Jentic: a few hours — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

ShipStation

Multi-carrier shipping platform that pairs with 4PL fulfilment

Use ShipStation alongside FDC when the merchant has self-fulfilled SKUs that need carrier label generation

Alternative

ShipBob

Direct-to-consumer 4PL with a similar order and inventory API

Choose ShipBob when the merchant is already on ShipBob's warehouse network rather than FDC's

Complementary

Shippo

Shipping rates and label generation across carriers

Pair Shippo with FDC when the integration needs ad-hoc rate shopping outside the FDC carrier network

Complementary

Shopify

Storefront platform that submits orders downstream to fulfilment

Use Shopify as the source of truth for orders and FDC as the fulfilment downstream

FAQs

Specific to using Fulfillment.com APIv2 API through Jentic.

What authentication does the Fulfillment.com APIv2 use?

FDC uses OAuth2 bearer tokens generated through POST /oauth/access_token, plus an x-api-key header. Implicit and password grant types are supported and refresh tokens rotate access. Through Jentic the client_id, client_secret, and api key are stored in the MAXsystem vault.

Can I submit a new order through the Fulfillment.com API?

Yes. POST /orders with merchantOrderId, line items, and a ship-to address. FDC validates the address, allocates stock, and returns the FDC order id. Use GET /orders/{id} to retrieve the resulting status.

What are the rate limits for the Fulfillment.com API?

FDC does not publish a fixed rate limit but documents that bulk submission should be paced and that idempotency on merchantOrderId protects against duplicates. Treat 5 to 10 calls per second as a polite ceiling and back off on 429 responses.

How do I track an order's shipment through Jentic?

Search Jentic for 'track a fulfillment.com order', load the GET /track schema, and execute with the order id. The response includes carrier and tracking number once FDC has assigned them at the dispatchDate milestone.

What do the six-digit FDC status codes mean?

FDC status codes are formatted as state, stage, and detail (for example 020601 means 'Fulfillment In Progress / Label Printed'). The spec lists every code so that integrations can map status to human-readable messaging without guessing.

Can I cancel an order after it has dispatched?

No. FDC documents that orders cannot be cancelled once they enter dispatch. Use DELETE /orders/{id} only before dispatchDate is set; afterwards a recall must go through the FDC account executive rather than the API.