Listando candidatos

Atenção: é obrigatório que a requisição realizada seja do tipo "Content-type: application/json".

Headers necessários:

Nome	Valor	Descrição
Authorization	Bearer ......................	Bearer Token para autenticação. Saiba mais aqui.
Content-Type	application/json	Define o tipo de formato de conteúdo que será enviado.

Uma vez que os Headers estejam devidamente configurados, podemos ir ao próximo passo.

Endpoint utilizado para listar os candidato

Endpoint	Método	Link para Teste
/api/v1/search/talents	POST	Loading...

Payload

Definição campo a campo para busca de candidatos por vaga na API:

Campo	Obrigatório	Tipo	Descrição
vacancy_id	Sim	array (int)	Lista de números inteiros para identificação de vagas. (para mais informações clique aqui
pipes	Não	array (int)	Lista de números inteiros para identificação de Etapas do processo seletivo. (para mais informações clique aqui (`pipeVacancy.pipe.pipe_stages`)

Parâmetros de URL (queryParams)

Definição campo a campo para busca de candidatos por vaga na API:

Campo	Obrigatório	Tipo	Descrição
page	Não	int	Número a página atual
perPage	Não	int	Número máximo de candidatos por página

Exemplo de Retorno

{
  "uuid": "fb6939c2e1953382da528f5718f82975",
  "export": "https://api.recrutei.com.br/api/v1/search/talents/export/fb6939c2e1953382da528f5718f82975",
  "links": {
    "first": "https://api.recrutei.com.br/api/v1/search/talents?page=1&perPage=20",
    "last": "https://api.recrutei.com.br/api/v1/search/talents?page=1&perPage=20",
    "next": "https://api.recrutei.com.br/api/v1/search/talents?page=1&perPage=20",
    "prev": null,
    "path": "https://api.recrutei.com.br/api/v1/search/talents"
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "path": "https://api.recrutei.com.br/api/v1/search/talents",
    "per_page": 1,
    "from": 0,
    "to": 20,
    "total": {
      "pages": 1,
      "items": 1
    }
  },
  "data": [
    {
      "id": 1,
      "talent_id": 1,
      "created_at": "21/09/2025",
      "stars": 0,
      "period": "19 horas atrás",
      "rated": null,
      "status": "Não avaliado",
      "pipe_stage_id": 1,
      "gender_identity": {
        "name": "Homem Cis",
        "id": 0
      },
      "photo_url": "https://url-do-avatar.com.br/exemplo.png",
      "name": "Jhon Doe",
      "email": "[email protected]",
      "age": 28,
      "last_experience": "Estágio de programador na Uappi",
      "location": "São Paulo, SP, Brasil",
      "socials": {
        "linkedin_url": "https://linkedin.com/in/john.doe",
        "curriculum_url": "https://url-do-curriculo.com.br/exemplo.pdf",
        "github_url": "https://github.com/john.doe",
        "website_url": "https://google.com/"
      }
    }
  ]
}