List Dictionary Entries

curl -G https://api.onepin.ai/api/v1/dictionary \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d language=en-us \
     -d limit=20 \
     -d method=spelled \
     -d method=recorded \
     -d offset=0 \
     -d order=desc \
     -d sort=uses_count

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "word": "schedule",
      "method": "recorded",
      "language": "en-us",
      "uses_count": 152,
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-10T14:45:00Z",
      "description": "Commonly used in business contexts",
      "pronunciation": "skedʒuːl",
      "audio_url": "https://audio.onepin.ai/presigned/abc123xyz?expires=1687000000",
      "ipa": "ˈskɛdʒ.uːl",
      "created_by": "d290f1ee-6c54-4b01-90e6-d701748f0851"
    }
  ],
  "meta": {
    "request_id": "7b9f8c2a-4d3e-4f1a-9a2b-1c2d3e4f5a6b",
    "timestamp": "2024-04-27T12:00:00Z"
  },
  "pagination": {
    "limit": 20,
    "next": "https://api.onepin.ai/api/v1/dictionary?language=en-us&offset=20&limit=20",
    "prev": null
  }
}

List dictionary entries for a single locale in the current workspace.

Returns a paginated list of entries for the BCP-47 language locale specified via the ?language= query parameter (required, e.g. ko-kr). Use GET /dictionary/search instead when you need to match by word text across multiple locales, or GET /dictionary/languages to discover which locales have entries before filtering here.

audio_url on entries with method=recorded is a short-lived presigned URL — do not cache it across sessions.

List dictionary entries for a single locale in the current workspace. Returns a paginated list of entries for the BCP-47 `language` locale specified via the `?language=` query parameter (required, e.g. `ko-kr`). Use `GET /dictionary/search` instead when you need to match by word text across multiple locales, or `GET /dictionary/languages` to discover which locales have entries before filtering here. `audio_url` on entries with `method=recorded` is a short-lived presigned URL — do not cache it across sessions.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Query parameters

methodlist of enums or nullOptional

Filter by one or more entry methods. Repeat to OR: ?method=spelled&method=recorded. Omit to return all methods.

Allowed values:

sortenumOptionalDefaults to created_at

Field to sort by. uses_count ranks the most-applied entries first, useful for auditing high-impact corrections.

Allowed values:

orderenumOptionalDefaults to desc

Sort direction.

Allowed values:

offsetintegerOptional>=0Defaults to 0

Zero-based pagination offset.

limitintegerOptional1-50Defaults to 20

Page size (max 50).

languageenumRequired

BCP-47 language code, e.g. en-us, ko-kr

Response

Successful Response

datalist of objects

metaobject

paginationobject

Errors

422

Unprocessable Entity Error

Authentication

Headers

Query parameters

Response

Errors