---
title: "Notify Fulfillment"
method: POST
path: "/payments/{payment_id}/fulfillments"
---

# Notify Fulfillment

`POST /payments/{payment_id}/fulfillments`

## Request

- Base URL: `https://api-sandbox.y.uno/v1`
- URL: `https://api-sandbox.y.uno/v1/payments/{payment_id}/fulfillments`
- Auth: API key in header `PUBLIC-API-KEY` and API key in header `PRIVATE-SECRET-KEY`
- TypeScript: <https://skmtc.dev/y/apis/ai-caller/docs/payments/:payment_id/fulfillments/post.ts> (a function with typed inputs; its response is checked against the schema)

Notify fulfillment status and shipping details for a payment order.

## Request body

- object
  - `status` 'PARTIAL' | 'COMPLETED' | 'REPLACEMENT' | 'CANCELED', required: The status of the order fulfillment.
  - `fulfillments` object[], required: Fulfillments array
    - `id` string, required: The unique identifier of the fulfillment (MAX 255; MIN 3)
    - `type` 'CUSTOM' | 'MILITARY' | 'ELECTRONIC' | 'EXPRESS' | 'STANDARD' | 'SCHEDULED' | 'ECONOMY' | 'PRIORITY' | 'SAME_DAY' | 'NEXT_DAY' | 'THIRD_DAY' | 'STORE_PICK_UP' | 'LOCKER_PICK_UP' | 'OTHER', required: The type of the fulfillment
    - `status` 'PARTIAL' | 'COMPLETED' | 'REPLACEMENT' | 'CANCELED', required: The status of the fulfillment.
    - `description` string: The description of the fulfillment. (MAX 255; MIN 3)
    - `carriers` object[]: Carriers array
      - `id` string, required: The unique identifier of the carrier (MAX 255; MIN 3)
      - `tracking_id` string[], required: Tracking identifiers from the carrier (MAX 255; MIN 3 per item)
      - `tracking_url` string[], required: Tracking URLs from the carrier (MAX 999; MIN 1 per item)
      - `shipped_at` string, date: Shipping date (YYYY-MM-DD)
      - `delivered_at` string, date: Delivery date (YYYY-MM-DD)
  - `carriers` unknown

## Response `202`

Accepted

- object

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/y/apis/ai-caller.md) - [All operations](https://skmtc.dev/y/apis/ai-caller/llms.txt) - [OpenAPI document](https://skmtc.dev/y/apis/ai-caller/revisions/05b629819b49?raw)