---
title: "List the category and place codes"
method: GET
path: "/api/v1/catalog"
---

# List the category and place codes

`GET /api/v1/catalog`

## Request

- Base URL: `https://ableandagent.com`
- URL: `https://ableandagent.com/api/v1/catalog`
- Auth: none required

Every category, and every market with its communities and the neighborhoods inside each, with labels and the market's timezone — the codes POST /api/v1/acts takes in category, community and neighborhood. No key is needed; a request without one is counted against its address.

## Response `200`

The catalog.

- Catalog: Every code an ACT may name, with its label, in display order.
  - `categories` object[], required: What kind of task an ACT is.
    - `code` string, required
    - `label` string, required
  - `markets` object[], required: Where ACTs can be: San Diego at launch.
    - `code` string, required
    - `label` string, required
    - `timezone` string, required: The market's IANA timezone, which every ACT's deadline is shown in.
    - `communities` object[], required
      - `code` string, required: What an ACT's community field takes.
      - `label` string, required
      - `neighborhoods` object[], required: What an ACT's neighborhood field takes, with this community beside it.
        - `code` string, required
        - `label` string, required
    - `zipCodes` object[], required: The ZIP codes an ACT's zip field takes, the City's.
      - `code` string, required
      - `communities` string[], required: The communities it lies in. The first is the one a place named by this ZIP code alone is in.
      - `neighborhoods` string[], required: The neighborhoods it shares 5 acres or more with, from the City of San Diego's neighborhood map: the ones the post form offers. A place with this ZIP code may also name another neighborhood in one of its communities.

## Other responses

- `429`: Too many requests for this key, or for this address without a key. Retry-After says how many seconds to wait. Codes: RATE_LIMITED.

---

[API](https://skmtc.dev/ableandagent/apis/able-and-agent-api.md) · [All operations](https://skmtc.dev/ableandagent/apis/able-and-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ableandagent/apis/able-and-agent-api/revisions/3bbf88fbc177?raw)