CoreCited
API docs menu

List brands

Every brand in the workspace, with the ids the other endpoints need.

GET/api/v1/brands

Start here. Every other endpoint takes a brand id, and this is where you get one.

Returns all brands in the workspace the key belongs to, oldest first. There is no pagination; a workspace holds at most a few dozen brands.

Parameters

None. There are no query parameters, filters or pagination.

Request

curl https://corecited.com/api/v1/brands \
  -H "Authorization: Bearer $CORECITED_API_KEY"

Response

200 OK with the fields below inside data. Numbers are JSON numbers, dates are strings, and a field listed as null-able is always present, holding null when there is no value.

FieldTypeDescription
[].idstringThe brand's id.
[].namestringThe brand name.
[].domainstringThe website as entered during setup, often a full URL.
[].createdAtstringWhen the brand was added. ISO 8601 timestamp, UTC.

Example

200 OK
{
  "data": [
    {
      "id": "7d1c2b9e-4a3f-4e61-9b2a-0c5d8e7f6a14",
      "name": "Acme Resume",
      "domain": "https://www.acmeresume.com/",
      "createdAt": "2026-08-02T09:14:31.482Z"
    }
  ]
}

Errors

StatusCodeWhen
401missing_keyNo key was sent in Authorization or x-api-key.
401invalid_keyThe key is malformed, unknown, or has been revoked.
402plan_requiredThe workspace is not on a plan that includes API access. This is checked on every request, so it also happens after a downgrade.
429rate_limitedThe workspace used up its requests for the current minute. All keys share one limit.
500internalSomething failed on our side. The response carries no detail by design.

Every error has the same body. See Errors for what to do about each one.