{"id":1878,"date":"2026-01-14T16:50:00","date_gmt":"2026-01-14T19:50:00","guid":{"rendered":"https:\/\/www.bancosemear.com.br\/docs\/?post_type=docs&p=1878"},"modified":"2026-04-20T14:03:54","modified_gmt":"2026-04-20T17:03:54","slug":"api-de-elegibilidade","status":"publish","type":"docs","link":"https:\/\/www.bancosemear.com.br\/docs\/?docs=api-de-elegibilidade","title":{"rendered":"API de Elegibilidade"},"content":{"rendered":"\n

1. Endpoint<\/h3>\n\n\n\n

POST \/api\/v1\/eligibility\/check
URL de teste: https:\/\/hmlapi2.bancosemear.com.br\/caas-eligible-api\/v1\/public\/eligibility<\/p>\n\n\n\n

2. Descri\u00e7\u00e3o<\/h3>\n\n\n\n

Verifica se um benefici\u00e1rio INSS est\u00e1 eleg\u00edvel para contrata\u00e7\u00e3o do empr\u00e9stimo consignado. A consulta \u00e9 male\u00e1vel e pode escolher consultar os org\u00e3os SRCC, NMP e MCB simultaneamente.<\/p>\n\n\n\n

3. Headers<\/h3>\n\n\n\n
Key<\/strong><\/td>Valor (apenas exemplo)<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
client_id<\/td>g5d9627b-a635-4043-8fdf-291f1eva3556<\/td>Identificador \u00fanico do cliente\/aplica\u00e7\u00e3o consumidora da API<\/td><\/tr>
access_token<\/td>9nf84610-5e6a-489a-8228-469a3d29fnf<\/td>Token de acesso Bearer\/JWT com escopo de
autoriza\u00e7\u00e3o<\/td><\/tr>
Content-Type<\/td>application\/json<\/td>Formato do corpo da requisi\u00e7\u00e3o<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

*acess_token precisa ser solicitado na API da Semear de autentica\u00e7\u00e3o:
https:\/\/api.bancosemear.com.br\/oauth\/access-token <\/a><\/p>\n\n\n\n

4. Request Body (application\/json)<\/h3>\n\n\n\n
{\n\"cpf\": \"52534996010\",\n\"numeroBeneficioINSS\": \"1111111111\",\n\"numeroTelefone\": \"11999999999\",\n\"cpfAgenteCredito\": \"52534996010\",\n\"srcc\": true,\n\"nmp\": true,\n\"mcb\": false\n}<\/code><\/pre>\n\n\n\n
5. Campos do corpo da requisi\u00e7\u00e3o<\/h3>\n\n\n\n
Campo<\/strong><\/td>Tipo<\/strong><\/td>Obrigat\u00f3rio<\/strong><\/td>Forma\/Regra<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td><\/tr>
cpf<\/td>string<\/td>Sim, quando srcc estiver como true<\/td>Exatamente 11 d\u00edgitos num\u00e9ricos<\/td>CPF do benefici\u00e1rio<\/td><\/tr>
numeroBeneficioINSS<\/td>string<\/td>Sim, quando srcc estiver como true<\/td>Exatamente 10 d\u00edgitos num\u00e9ricos<\/td>N\u00famero do Benef\u00edcio \/ NB
INSS<\/td><\/tr>
numeroTelefone<\/td>string<\/td>Sim, quando nmp estiver como true<\/td>10 ou 11 d\u00edgitos num\u00e9ricos<\/td>Telefone fixo (10) ou celular (11)<\/td><\/tr>
cpfAgenteCredito<\/td>string<\/td>Sim, quando mcb estiver como true<\/td>Exatamente 11 d\u00edgitos num\u00e9ricos<\/td>CPF do agente de cr\u00e9dito \/
correspondente<\/td><\/tr>
srcc<\/td>boleano<\/td>Sim<\/td>True ou false<\/td>Ativa a consulta no SRCC<\/td><\/tr>
nmp<\/td>boleano<\/td>Sim<\/td>True ou false<\/td>Ativa a consulta no NMP<\/td><\/tr>
mcb<\/td>boleano<\/td>Sim<\/td>True ou false<\/td>Ativa a consulta no MCB<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Respostas Esperadas<\/p>\n\n\n\n
C\u00f3digo<\/td>Descri\u00e7\u00e3o<\/td>Exemplo de corpo da
resposta<\/td><\/tr>
201<\/td>Processado com sucesso<\/td>{“elegivel”: true } ou {
“elegivel”: false,
“mensagem”: “Benef\u00edcio
bloqueado para
consigna\u00e7\u00e3o” }<\/td><\/tr>
400<\/td>Erro de valida\u00e7\u00e3o (formato \/
campos)<\/td>		{ “errors”: { “cpf”: [“O CPF
deve conter 11 d\u00edgitos.”] } }<\/td><\/tr>
500<\/td>Erro interno do servidor<\/td>{“message”: “Erro interno.
Tente novamente mais tarde.” }<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Exemplos de Resposta 201 OK
Eleg\u00edvel:<\/p>\n\n\n\n
{\n\"elegivel\": true<\/strong>\n}<\/code><\/pre>\n\n\n\n
Eleg\u00edvel (sempre que o MCB for informado como true):<\/p>\n\n\n\n
{\n    \"elegivel\": true,\n    \"pontuacaoMes\": 0,\n    \"pontuacaoAcumulada\": 0\n}<\/code><\/pre>\n\n\n\n
N\u00e3o eleg\u00edvel:<\/p>\n\n\n\n
{\n\"elegivel\": false,<\/strong>\n\"mensagem\": \u201d SRCC: Situa\u00e7\u00e3o n\u00e3o permitida pela SRCC: resultado: BLOQUEADO, prazo \nexpira\u00e7\u00e3o: 61, tipo evento: DESBLOQUEIO\u201d<\/strong>\n}<\/code><\/pre>\n\n\n\n
N\u00e3o eleg\u00edvel (sempre que o MCB for informado como true):<\/p>\n\n\n\n
{\n\"elegivel\": false,<\/strong>\n\"pontuacaoMes\": 0,\n\"pontuacaoAcumulada\": 0\n\"mensagem\": \u201d SRCC: Situa\u00e7\u00e3o n\u00e3o permitida pela SRCC: resultado: BLOQUEADO, prazo \nexpira\u00e7\u00e3o: 61, tipo evento: DESBLOQUEIO\u201d<\/strong>\n}<\/code><\/pre>\n\n\n\n
6. Evid\u00eancia de teste<\/h3>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Figura 1 \u2013 Par\u00e2metros via header<\/strong><\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Figura 2 \u2013 Par\u00e2metros do body (payload)<\/strong><\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Figura 3 \u2013 Retorno do processamento<\/strong><\/p>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
1. Endpoint POST \/api\/v1\/eligibility\/checkURL de teste: https:\/\/hmlapi2.bancosemear.com.br\/caas-eligible-api\/v1\/public\/eligibility 2. Descri\u00e7\u00e3o Verifica se um benefici\u00e1rio INSS est\u00e1 eleg\u00edvel para contrata\u00e7\u00e3o do empr\u00e9stimo consignado. A consulta \u00e9 male\u00e1vel e pode escolher consultar os org\u00e3os SRCC, NMP e MCB simultaneamente. 3. Headers Key Valor (apenas exemplo) Descri\u00e7\u00e3o client_id g5d9627b-a635-4043-8fdf-291f1eva3556 Identificador \u00fanico do cliente\/aplica\u00e7\u00e3o consumidora da API access_token 9nf84610-5e6a-489a-8228-469a3d29fnf Token …<\/p>\n
  API de Elegibilidade<\/span> Leia mais »<\/a><\/p>\n","protected":false},"author":14,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-global-header-display":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","footnotes":""},"doc_category":[55],"doc_tag":[],"class_list":["post-1878","docs","type-docs","status-publish","hentry","doc_category-consignado_inss"],"_links":{"self":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1878","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1878"}],"version-history":[{"count":5,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1878\/revisions"}],"predecessor-version":[{"id":2017,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=\/wp\/v2\/docs\/1878\/revisions\/2017"}],"wp:attachment":[{"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1878"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_category&post=1878"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.bancosemear.com.br\/docs\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=1878"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}