> ## 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.

# Check which candidates are already in your talent network

> Use before bulk submit: up to 500 identities, each email, linkedinUrl or both, checked against your network. linkedinUrl wins when both given. Values never rejected; unknown answers inNetwork false. inNetwork false for candidate only in another agency's network. Read-only.

Required scopes: `talent_network:read`.



## OpenAPI

````yaml /api/openapi.json post /talent-network/candidates/lookup
openapi: 3.0.0
info:
  title: Paraform API
  version: v1
servers:
  - url: https://external-api.paraform.com/api/external/v1
security: []
paths:
  /talent-network/candidates/lookup:
    post:
      summary: Check which candidates are already in your talent network
      description: >-
        Use before bulk submit: up to 500 identities, each email, linkedinUrl or
        both, checked against your network. linkedinUrl wins when both given.
        Values never rejected; unknown answers inNetwork false. inNetwork false
        for candidate only in another agency's network. Read-only.


        Required scopes: `talent_network:read`.
      operationId: lookupTalentNetworkCandidates
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                identities:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
                        nullable: true
                        description: Candidate email, e.g. jane@example.com.
                      linkedinUrl:
                        type: string
                        nullable: true
                        description: >-
                          LinkedIn profile URL, e.g. linkedin.com/in/jane-doe.
                          Wins over email.
                  minItems: 1
                  maxItems: 500
                  description: 1-500 identities; more is rejected with 400.
              required:
                - identities
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        inNetwork:
                          type: boolean
                        candidateUserId:
                          type: string
                        status:
                          type: string
                          enum:
                            - on_market
                            - off_market
                          description: >-
                            `on_market`: ParaAI considering candidate;
                            daysRemaining counts down window. `off_market`: in
                            network, not considered.
                        daysRemaining:
                          type: integer
                          nullable: true
                      required:
                        - inNetwork
                required:
                  - results
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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