> ## Documentation Index > Fetch the complete documentation index at: https://docs.hihobbes.com/llms.txt > Use this file to discover all available pages before exploring further. # List Custom Link job items > Return per-link creation, validation, URL, and thumbnail outcomes. Requires `custom_links:read` or `custom_links:write`. Items remain in deterministic input order. Each item has independent creation and thumbnail statuses, so a terminal job can still contain item-level errors. ## OpenAPI ````yaml api-reference/openapi.json GET /api/v1/custom-link-jobs/{job_id}/items openapi: 3.1.0 info: title: Hobbes API description: > Use the Hobbes API to read your organization's analyzed demo sessions, prospects, accounts, transcripts, and funnel metrics, and to create and manage personalized Custom Links. **Authentication**: create an API key in Settings → API Keys, then send it as `Authorization: Bearer ` (or `x-api-key: `). Keys are org-scoped; responses only ever contain your organization's data. **Scopes**: keys carry scopes (`sessions:read`, `people:read`, `accounts:read`, `analytics:read`, `transcripts:read`, `custom_links:read`, `custom_links:write`). `custom_links:write` also satisfies read access. Raw transcript access is a separate opt-in scope with a daily quota. Existing API keys do not receive Custom Link scopes automatically. **Rate limits**: keys allow 120 requests per minute by default. Responses include `X-RateLimit-Limit` and `X-RateLimit-Remaining`; 429 responses include `Retry-After`. Transcript access has a separate quota of 2,000 reads per organization per UTC day. Custom Link mutations are limited to 10 requests per minute per organization. Creation and thumbnail rendering also use weighted hourly and daily organization quotas, so one request containing 500 links is one HTTP request but consumes up to 500 creation and 500 render units. **Support**: every response carries an `X-Request-ID` header. Include it when reporting an issue so we can find the exact request in our logs. **Stability**: changes within v1 are additive only. Fields may be added to responses; existing fields are never removed or renamed. version: 1.0.0 servers: - url: https://api-us.hihobbes.com description: Production security: - bearer: [] - apiKeyHeader: [] tags: - name: Sessions description: Analyzed demo sessions and their transcripts. - name: People description: Prospect profiles aggregated across sessions. - name: Accounts description: Company-level engagement rollups by email domain. - name: Metrics description: Aggregate funnel performance over a trailing window. - name: Custom Links description: Create and manage personalized links. - name: Custom Link Jobs description: Poll, cancel, and retry asynchronous Custom Link work. - name: Custom Link Campaigns description: Organize Custom Links into campaigns. paths: /api/v1/custom-link-jobs/{job_id}/items: get: tags: - Custom Link Jobs summary: List Custom Link job items description: >- Return paginated per-link creation, validation, URL, and thumbnail outcomes in deterministic input order. operationId: v1_list_custom_link_job_items parameters: - name: job_id in: path required: true schema: type: string format: uuid title: Job Id description: Custom Link job UUID. description: Custom Link job UUID. - name: limit in: query required: false schema: type: integer maximum: 500 minimum: 1 default: 100 title: Limit description: Number of records to return. Defaults to 50 and cannot exceed 200. description: Number of records to return. Defaults to 50 and cannot exceed 200. - name: offset in: query required: false schema: type: integer maximum: 1000000 minimum: 0 default: 0 title: Offset description: >- Zero-based number of records to skip. Use with `pagination.total` to request the next page. description: >- Zero-based number of records to skip. Use with `pagination.total` to request the next page. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CustomLinkJobItemsResponse' headers: X-Request-ID: description: Unique request identifier to include in support requests. schema: type: string example: req_01JABCDEF23456789 X-RateLimit-Limit: description: Request limit for this key in the current 60-second window. schema: type: integer example: 120 X-RateLimit-Remaining: description: Requests remaining for this key in the current window. schema: type: integer example: 119 '401': description: API key required or invalid. headers: X-Request-ID: description: Unique request identifier to include in support requests. schema: type: string example: req_01JABCDEF23456789 content: application/json: schema: type: object required: - detail properties: detail: type: string example: API key required or invalid. '403': description: API key does not include the required scope. headers: X-Request-ID: description: Unique request identifier to include in support requests. schema: type: string example: req_01JABCDEF23456789 content: application/json: schema: type: object required: - detail properties: detail: type: string example: API key does not include the required scope. '404': description: Custom Link job not found in the key's organization. headers: X-Request-ID: description: Unique request identifier to include in support requests. schema: type: string example: req_01JABCDEF23456789 content: application/json: schema: type: object required: - detail properties: detail: type: string example: Custom Link job not found in the key's organization. '422': description: A path, query, header, or request field failed validation. content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' headers: X-Request-ID: description: Unique request identifier to include in support requests. schema: type: string example: req_01JABCDEF23456789 '429': description: Rate limit or organization quota exceeded. headers: X-Request-ID: description: Unique request identifier to include in support requests. schema: type: string example: req_01JABCDEF23456789 X-RateLimit-Limit: description: Request limit for this key in the current 60-second window. schema: type: integer example: 120 X-RateLimit-Remaining: description: Requests remaining for this key in the current window. schema: type: integer example: 119 Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 30 X-RateLimit-Reset: description: Unix timestamp when the limiting window resets. schema: type: integer content: application/json: schema: type: object required: - detail properties: detail: type: string example: Rate limit or organization quota exceeded. components: schemas: CustomLinkJobItemsResponse: properties: items: items: $ref: '#/components/schemas/CustomLinkJobItemResponse' type: array title: Items total: type: integer title: Total limit: type: integer title: Limit offset: type: integer title: Offset type: object required: - items - total - limit - offset title: CustomLinkJobItemsResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CustomLinkJobItemResponse: properties: id: type: string format: uuid title: Id index: type: integer title: Index externalId: anyOf: - type: string - type: 'null' title: Externalid customLinkId: anyOf: - type: string format: uuid - type: 'null' title: Customlinkid url: anyOf: - type: string - type: 'null' title: Url creationStatus: type: string enum: - pending - created - failed - cancelled title: Creationstatus thumbnailStatus: type: string enum: - not_requested - provided - queued - processing - generated - fallback - failed - cancelled title: Thumbnailstatus error: anyOf: - $ref: '#/components/schemas/CustomLinkError' - type: 'null' warnings: items: type: string type: array title: Warnings type: object required: - id - index - creationStatus - thumbnailStatus title: CustomLinkJobItemResponse ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError CustomLinkError: properties: code: type: string title: Code message: type: string title: Message type: object required: - code - message title: CustomLinkError securitySchemes: bearer: type: http scheme: bearer description: Hobbes API key with the `hb_live_` prefix. apiKeyHeader: type: apiKey in: header name: x-api-key description: Alternative to the Bearer authorization header. ````