---
title: "GET /retailers/public/{retailer_id}"
method: GET
path: "/retailers/public/{retailer_id}"
tags: ["Retailers"]
---

# GET /retailers/public/{retailer_id}

`GET /retailers/public/{retailer_id}`

This endpoint retrieves information about a retailer given their ID. Use the isUpmarketPlusRetailer field to determine whether the retailer requires a packing slip in every shipping package when fulfilling their orders.

## Path parameters

- `retailer_id` string, required

## Response `200`

Successful response

- GetExternalRetailerProfileResponseV2 — Response containing information about a retailer who placed an order with the brand.
  - `retailer_id` string — A unique identifier for the retailer.
  - `name` string — The name of the retailer's business.
  - `is_insider` boolean — Indicates whether this retailer currently has an active Faire Insider membership. This field is true if the retailer has an active isInsider membership (TRIALING or ACTIVE status), and false otherwise (no membership, or CANCELLED/UNPAID/PAUSED status).
  - `is_upmarket_plus_retailer` boolean — Indicates whether this retailer is an Upmarket Plus retailer.
  - `business_identifiers` ExternalBusinessIdentifierV2[] — The retailer's tax and business-registration identifiers (e.g. VAT, EORI, ABN, GST), for use on invoices and customs paperwork. Empty unless you have an existing order with this retailer.
    - `identifier_type` string — The type of identifier (e.g. "VAT", "EORI", "ABN", "GST").
    - `identifier_value` string — The identifier value (e.g. "GB123456789").

## Other responses

- `400` — Bad Request -- Your request is invalid.
- `401` — Unauthorized -- Your API key is wrong.
- `404` — Not found -- The requested resource could not be found.
- `405` — Method Not Allowed -- You tried to access an entity with an invalid method.
- `429` — Too Many Requests.
- `500` — Internal Server Error -- We had a problem with our server. Try again later.
- `503` — Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

---

[API](https://skmtc.net/faire/apis/faire-external-api.md) · [All operations](https://skmtc.net/faire/apis/faire-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/faire/faire-external-api/revisions/19558399745c/schema)
