Enrich

Get Enrichment Job

Poll enrichment job status and get results.

Returns results progressively — partial results are available while the job is still running, as each batch of items completes processing.

Flow:

  1. Submit enrichment with async_mode=true → get job_id
  2. Poll this endpoint — results appear incrementally as items are processed
  3. When status changes to completed, all results are ready

Pagination:

  • page: Page number (1-indexed, default: 1)
  • page_size: Results per page (default: 1000)
  • Response includes page, page_size, total_pages, completed_items

Statuses:

  • running: Job is still processing (partial results may be available)
  • completed: Job finished, all results ready
  • failed: Job failed or was cancelled (partial results may still be available)

Example:

GET /api/public/enrich/{job_id}?page=1&page_size=50

Response (running, partial results):
{
    "job_id": "08aa2b0d-...",
    "status": "running",
    "results": [
        {"after_data": {...}, "before_data": {...}, "sources": {...}}
    ],
    "total_items": 500,
    "completed_items": 200,
    "successful": 0,
    "credits_used": 0,
    "page": 1,
    "page_size": 50,
    "total_pages": 4
}
get/public/enrich/{job_id}

Request

  • Base URL
    https://catalogapi.rastro.ai/api
  • Auth
    HTTP bearer

Path parameters

job_idstring required

Query parameters

pageinteger
page_sizeinteger

Headers

X-Organization-Idstring nullable

Response

Successful Response

job_idstring nullable

Job ID for tracking (always returned). Use this with source_activity_id to trigger full run.

total_itemsinteger required

Number of items being processed (may be limited by max_rows)

total_rowsinteger nullable

Total items passed in the request (before max_rows limit)

successfulinteger

Number of successfully enriched items

credits_usedinteger

Number of credits used (1 per successful item)

statusstring

Job status: 'running' (async) or 'completed' (sync)

service_usageobject nullable

Detailed API usage metrics (costs, calls, tokens) - only present when job is complete

pricing_estimatesobject nullable

Estimated pricing breakdown (for example knowledge-base storage + model runtime costs when available)

knowledge_base_enabledboolean nullable

Whether this enrichment job used a knowledge base vector store

knowledge_base_sourcesobject nullable

SOURCE_X -> hosted document URL mapping for knowledge-base files used by the activity

pageinteger nullable

Current page number (1-indexed)

page_sizeinteger nullable

Number of results per page

total_pagesinteger nullable

Total number of pages available

completed_itemsinteger nullable

Number of items with results available so far (useful while status=running)

Changes

No recorded changes to this operation across all 1 revision of this API.