Models
The Listing object
Every field of the Listing object — types, required flags and validation rules.
The Listing object
| Field | Type | Description |
|---|---|---|
id | string | e.g. list_9ac2e |
object | string | always listing |
product_id | string | |
channel_account_id | string | |
channel | string | Base channel of the account (denormalized for convenience). |
status | ListingStatus | New values may be added; tolerate unknowns. — one of: listed, imported, ongoing, error, delisted |
id_on_channel | string · nullable | |
url_on_channel | string · nullable | uri |
site | string · nullable | eBay only — the marketplace site this listing lives on (e.g. US, Italy). Stamped at publish. |
overrides | object | Per-channel content overrides; unset fields fall back to the product. |
overrides.title | string · nullable | |
overrides.description | string · nullable | |
overrides.category_id | string · nullable | |
attributes | object | Channel/category attributes (eBay item aspects, Etsy properties…). Open object in this spec; validated at write time against the category's attribute_schema. |
variants | array of ListingVariant | |
issues | array of Issue | |
operation_id | string · nullable | The operation tracking the last write on this listing. |
created_at | string | ISO 8601 |
updated_at | string | ISO 8601 |
Request models
What you send when creating or updating. Anything not listed is rejected.
ListingCreate
| Field | Type | Required | Description |
|---|---|---|---|
product_id | string | required | |
channel_account_id | string | required | |
site | string | optional | eBay only — target marketplace site for NEW listings; defaults to the account's configured site. |
overrides | object | optional | Not available yet — sending a non-empty object returns 422. Arrives in a later release. |
overrides.title | string | optional | |
overrides.description | string | optional | |
overrides.category_id | string | optional | |
attributes | object | optional | Not available yet — arrives with the attribute_schema discovery endpoints. |
ListingUpdate
| Field | Type | Required | Description |
|---|---|---|---|
overrides | object | optional | |
overrides.title | string · nullable | optional | |
overrides.description | string · nullable | optional | |
overrides.category_id | string · nullable | optional | |
attributes | object | optional |
Last updated on July 30, 2026
Need help?
The API is in private beta — email us and a human replies, usually within one business day.