Listing Endpoints

Fulfill a listing

Changed on Nov 3, 2026

Retrieve all the information, including signatures, needed to fulfill a listing directly onchain.

post/api/v2/listings/fulfillment_data

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/listings/fulfillment_data/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

include_optional_creator_feesboolean nullable

Whether to include optional creator fees in the fulfillment. If creator fees are already required, this is a no-op. Defaults to false.

recipientstring

units_to_fillinteger nullable

Optional quantity of units to fulfill; defaults to remaining units for listings

Response

Listing fulfillment data retrieved successfully

protocolstring required

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  the response property // became nullable for the status
- breaking
  the response property ////////// became nullable for the status
- breaking
  the response property /////////// became nullable for the status
- breaking
  the response property ///////// became nullable for the status
- breaking
  the response property ////////// became nullable for the status
- breaking
  the response property ////////// became nullable for the status
- breaking
  the response property /////////// became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property ////////// became optional for the status
- breaking
  the response property ///////// became optional for the status
- breaking
  the response property ////////// became optional for the status
- breaking
  the ////////// response's property type changed from object to no type for status
- breaking
  the ///////// response's property type changed from object to no type for status
- breaking
  the ////////// response's property type changed from object to no type for status
- breaking
  removed the required property /////////// from the response with the status
- breaking
  removed the required property ////////// from the response with the status
- breaking
  removed the required property /////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property /////////// from the response with the status
- info
  the request property became nullable
- info
  the request property became nullable
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added subschema #2 to the ////////// response property anyOf list for the response status
- info
  added subschema #2 to the ///////// response property anyOf list for the response status
- info
  added subschema #2 to the ////////// response property anyOf list for the response status

Operation history

Fulfill a listing

Request

Request body

Response 200OK

Changes

Response