Projects

List translation projects

List projects created with your API key, using cursor pagination and the documented filters.

GET/projects

API key permission: projects:read.

Parameters

NameTypeDescription
limitinteger · optional

query parameter

cursorstring · optional

Opaque signed cursor from next_cursor.

statusstring · optional

query parameter

external_idstring · optional

query parameter

created_afterstring · optional

query parameter

created_beforestring · optional

query parameter

Standard response headers

HeaderExampleDescription
Stepes-Request-Idb09de4aa-3874-4991-b85c-0bc86e780511

Server-generated request identifier for support and audit correlation.

Stepes-API-Version2.0.0

Effective Stepes API semantic version.

RateLimit-Policy120;w=60

Effective request limit and window for the authenticated key.

RateLimitlimit=120, remaining=119, reset=60

Current limit, remaining requests, and reset interval.

Responses

200

Project page

422

Request validation failed

{
  "object": "list",
  "data": [
    {
      "id": "proj_01JZ8K6N2W6RX4J9P7Y8K3M2Q1",
      "object": "project",
      "external_id": "SKU-1042-ES",
      "name": "Catalog SKU 1042",
      "status": "new",
      "progress": 0,
      "source_language": "EN-US",
      "target_languages": [
        "ES-ES"
      ],
      "source_files": [
        {
          "id": "file_01JZ8K6N2W6RX4J9P7Y8K3M2Q2",
          "object": "file",
          "filename": "catalog-sku-1042.json",
          "mime_type": "application/json",
          "size": 142,
          "status": "ready",
          "download_url": "https://apis.stepes.com/v2/files/file_01JZ8K6N2W6RX4J9P7Y8K3M2Q2/download",
          "content_url": "https://apis.stepes.com/v2/files/file_01JZ8K6N2W6RX4J9P7Y8K3M2Q2/content"
        }
      ],
      "due_at": null,
      "jobs": [],
      "delivery_ready": false,
      "invoice": {
        "status": "Unpaid",
        "currency": "USD",
        "total": 25,
        "due_at": "2026-09-08T00:00:00+00:00"
      },
      "created_at": "2026-08-10T12:00:00+00:00",
      "updated_at": "2026-08-10T12:00:00+00:00"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}