Projects

Get project status and details

Return current status, progress, source files, target-language work, delivery readiness, and billing summary.

GET/projects/{projectId}

API key permission: projects:read.

Parameters

NameTypeDescription
projectIdstring · required

path 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

404

Resource was not found or is not available to this API key

{
  "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"
}