Currículos

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://apiexportacaodecandidatos.vag.as/doc/exportacaodecandidatos/mcp

Standard setup for AI tools providing an mcp.json file

{
  "exportacaodecandidatos MCP server": {
    "url": "https://apiexportacaodecandidatos.vag.as/doc/exportacaodecandidatos/mcp"
  }
}

GET /jobs/resumes.json

Bearer auth

A requisição pode ser feita através dos parâmetros a seguir, que são obrigatórios:

ID da vaga (job_id); ou
Intervalo de datas (export_date_start e export_date_end)

Parâmetros opcionais:

page (se não for informado, retornará todos os registros em apenas 1 página)
per_page (se não for informado, retornará como padrão 10 registros por página)
include_additions (indica se os adendos serão incluidos no retorno)

Importante:

O intervalo de datas leva em consideração a data em que o candidato foi movido para a fase de exportação
O intervalo máximo permitido entre datas é de 12 meses

Query parameters

job_id string

Id da vaga que será solicitados os candidatos.
export_date_start string(date)

Data de inicio para busca de candidatos.
export_date_end string(date)

Data de termino para busca de candidatos.
page number

Número da página a ser retornada.

Default value is 1.
per_page number

Limite de registros para retornar por página.

Default value is 10.
include_additions boolean

parametro para indicar se os adendos serão incluidos no retorno.

Default value is false.

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- id number
- nome_completo string | null
- data_de_nascimento string | null
- identidade_de_genero string | null
- documentos array[object]
  
  Hide documentos attributes Show documentos attributes object
  
  documento string
  
  Tipo do documento, CPF, RG, Passaporte, ...
  
  pais string
  
  numero string
- email string | null
- versao_pdf string | null
- pessoa_com_deficiencia boolean
- nacionalidade string | null
- telefone_celular object
  
  Hide telefone_celular attributes Show telefone_celular attributes object
  
  ddi string | null
  
  ddd string | null
  
  number string | null
- telefone_residencial string | null
  
  Pode conter pequenas frases, não apenas números
- endereco object
  
  Hide endereco attributes Show endereco attributes object
  
  bairro string | null
  
  cep string | null
  
  complemento string | null
  
  logradouro string | null
  
  numero string | null
  
  pais string | null
  
  estado string | null
  
  cidade string | null
  
  latitude string | null
  
  longitude string | null
- nivel_de_escolaridade string | null
- autodeclaracao_racial string | null
- adendos object
  
  Adendos podem ter N propriedades, sendo o nome do atributo definido pelo nome do adendo
  
  Hide adendos attribute Show adendos attribute object
  
  * object Additional properties
  
  Nome dos adendos podem ter N perguntas, sendo o nome do atributo definido pelo nome identificador da pergunta
  
  Hide * attribute Show * attribute object
  
  * object Additional properties
  
  Hide * attributes Show * attributes object
  
  pergunta string
  
  resposta string
401 application/json

Unauthorized
Hide response attributes Show response attributes object
- error string
- status number
404 application/json

Not Found
Hide response attributes Show response attributes object
- error string
- status number
412 application/json

Resposta para quando algum dos parametros são inválidos, o retorno pode ser um ou mais dos valores definidos na resposta de exemplo
Hide response attributes Show response attributes object
- error object
  
  Hide error attributes Show error attributes object
  
  base array[string]
  
  export_date_start array[string]
  
  export_date_end array[string]
  
  job_id array[string]
  
  page array[string]
  
  per_page array[string]
- status number

GET /jobs/resumes.json

curl \
 --request GET 'https://apigateway.vagas.com.br/v1/applicants-export/jobs/resumes.json' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

[
  {
    "id": 1085180,
    "nome_completo": "José Fictício Barbosa Júnior",
    "data_de_nascimento": "1967-01-23",
    "identidade_de_genero": "homem cisgênero",
    "documentos": [
      {
        "documento": "CPF (BRA)",
        "pais": "Brasil",
        "numero": "12345678900"
      }
    ],
    "email": "teste@vagas.com.br",
    "versao_pdf": "string",
    "pessoa_com_deficiencia": false,
    "nacionalidade": "Brasileiro",
    "telefone_celular": {
      "ddi": "55",
      "ddd": "11",
      "number": "999999999"
    },
    "telefone_residencial": "(11) 1234-5678",
    "endereco": {
      "bairro": "string",
      "cep": "60871680",
      "complemento": "string",
      "logradouro": "Rua Iraci, 123 - Apto 7",
      "numero": "string",
      "pais": "Brasil",
      "estado": "MG",
      "cidade": "Belo Horizonte",
      "latitude": "-23.5071871",
      "longitude": "-46.8965909"
    },
    "nivel_de_escolaridade": "Formação superior completa",
    "autodeclaracao_racial": "string",
    "adendos": {
      "additionalProperty1": {
        "additionalProperty1": {
          "pergunta": "Qual a palabra certa?",
          "resposta": "A"
        },
        "additionalProperty2": {
          "pergunta": "Qual a palabra certa?",
          "resposta": "A"
        }
      },
      "additionalProperty2": {
        "additionalProperty1": {
          "pergunta": "Qual a palabra certa?",
          "resposta": "A"
        },
        "additionalProperty2": {
          "pergunta": "Qual a palabra certa?",
          "resposta": "A"
        }
      }
    }
  }
]

Response examples (401)

{
  "error": "Usuário não autenticado",
  "status": 401
}

Response examples (404)

{
  "error": "Resource not found",
  "status": 404
}

Response examples (412)

{
  "error": {
    "base": [
      "Datas devem ter intervalo máximo de 1 ano"
    ],
    "export_date_start": [
      "deve ser uma data"
    ],
    "export_date_end": [
      "deve ser uma data"
    ],
    "job_id": [
      "deve ser um numero"
    ],
    "page": [
      "deve ser maior ou igual a 1"
    ],
    "per_page": [
      "deve ser menor ou igual a 100"
    ]
  },
  "status": 412
}