---
title: "Get a listing"
method: GET
path: "/api/v1/sa/inventory/listings/{id}"
tags: ["Listings"]
---

# Get a listing

`GET /api/v1/sa/inventory/listings/{id}`

## Request

- Base URL: `https://app.sellerassistant.app` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sellerassistant.app/api/v1/sa/inventory/listings/{id}`
- Auth: one of:
  - API key in query parameter `api_key`
  - API key in header `X-Api-Key`

Gives one listing of the team.

## Path parameters

- `id` integer, required

## Response `200`

The listing

- object
  - `data` Listing: The live state of one SKU on one channel.
    - `id` integer
    - `team_id` integer
    - `sku_id` integer, nullable
    - `channel` 'amazon' | 'walmart' | 'shopify' | 'ebay'
    - `marketplace_id` string, nullable
    - `seller_id` string, nullable
    - `sku` string
    - `identifier` string, nullable
    - `price` number, nullable
    - `currency` string, nullable
    - `condition` string, nullable
    - `fulfillment_type` string, nullable
    - `status` string
    - `error_message` string, nullable
    - `channel_data` object, nullable
    - `listed_at` string, date-time, nullable
    - `batch_id` string, nullable: The batch the draft was made in.
    - `sku_record` object, nullable: The SKU the listing sells, and the product behind it. The list and the read of one listing carry it; a draft the call has just written does not.
      - `id` integer
      - `sku` string, nullable
      - `asin` string, nullable
      - `fnsku` string, nullable
      - `internal_product_id` string, nullable
      - `product_title` string, nullable
      - `product_image_url` string, nullable
      - `internal_product` object, nullable
        - `id` string
        - `title` string, nullable
        - `brand` string, nullable
        - `image_url` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `403`: Access denied - insufficient permissions, invalid API key, or the API request limit is used up (`public_api_key_limit`)
- `404`: Resource not found
- `429`: Too many requests - rate limit exceeded

---

[API](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api.md) · [All operations](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/revisions/5b3ecdbcadb6?raw)