> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paraform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Per-item status of a talent-network submission batch

> Use to poll outcome of submit or submit-bulk. Items rejected at submit time have no row, so index gaps possible. failed always resubmittable. Treat unknown errorCode as terminal failure. queued or processing never permanent: times out as ingest_timed_out after few hours.

Required scopes: `talent_network:read`.



## OpenAPI

````yaml /api/openapi.json get /talent-network/batches/{batchId}
openapi: 3.0.0
info:
  title: Paraform API
  version: v1
servers:
  - url: https://external-api.paraform.com/api/external/v1
security: []
paths:
  /talent-network/batches/{batchId}:
    get:
      summary: Per-item status of a talent-network submission batch
      description: >-
        Use to poll outcome of submit or submit-bulk. Items rejected at submit
        time have no row, so index gaps possible. failed always resubmittable.
        Treat unknown errorCode as terminal failure. queued or processing never
        permanent: times out as ingest_timed_out after few hours.


        Required scopes: `talent_network:read`.
      operationId: getTalentNetworkBatch
      parameters:
        - schema:
            type: string
            format: uuid
            description: batchId from submit or submit-bulk response, UUID.
          required: true
          description: batchId from submit or submit-bulk response, UUID.
          name: batchId
          in: path
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  batchId:
                    type: string
                    format: uuid
                  createdAt:
                    type: string
                  itemCount:
                    type: integer
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        submissionId:
                          type: string
                          format: uuid
                        index:
                          type: integer
                        clientReferenceId:
                          type: string
                        status:
                          type: string
                          enum:
                            - queued
                            - processing
                            - succeeded
                            - failed
                            - deduplicated
                          description: >-
                            `processing` can take tens of seconds. `succeeded`:
                            in network, candidateUserId set. `failed`: terminal,
                            errorCode set, resubmittable. `deduplicated`:
                            identical submission already in flight.
                        errorCode:
                          type: string
                          description: >-
                            Stable codes: invalid_linkedin_url, invalid_email,
                            invalid_resume_reference, recruiter_not_found,
                            recruiter_deactivated, resume_parse_failed,
                            resume_identity_mismatch,
                            linkedin_profile_not_found, linkedin_no_experience,
                            linkedin_verification_unavailable,
                            upload_limit_reached, internal_error,
                            enqueue_failed, ingest_timed_out. New codes may be
                            added.
                        errorMessage:
                          type: string
                        candidateUserId:
                          type: string
                        updatedAt:
                          type: string
                      required:
                        - submissionId
                        - index
                        - status
                        - updatedAt
                required:
                  - batchId
                  - createdAt
                  - itemCount
                  - items
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.