---
title: "Check status of a post collection job"
method: GET
path: "/v1/tracking/creators/{id}/posts/collect/{collection_id}"
tags: ["Tracking"]
---

# Check status of a post collection job

`GET /v1/tracking/creators/{id}/posts/collect/{collection_id}`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/tracking/creators/{id}/posts/collect/{collection_id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required
- `collection_id` string, required

## Response `200`

Collection status

- CollectPostsStatusResponseDto
  - `data` CollectPostsStatusDataDto, required
    - `collection_id` string, required
    - `status` 'processing' | 'completed' | 'failed', required
    - `depth` 'standard' | 'deep' | 'full', required
    - `videos_collected` number, nullable
    - `max_videos` number, required
    - `started_at` string, nullable
    - `completed_at` string, nullable
    - `error` string, nullable
    - `credits_refunded` number: Credits paid back because the collection found no posts or failed. Present only when a refund was made.

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `404`: Collection job not found
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)