---
title: "Step 1 - Simple signup"
method: POST
path: "/v2.1/process/simple_signup"
tags: ["Credit Request"]
---

# Step 1 - Simple signup

`POST /v2.1/process/simple_signup`

# Simple signup
>* Make sign up of users (can return error if user already registered)
>* NOTE: Client_id is blocked if this call is made to the same CPF more than 20 times in the same day
>>* Realiza o cadastro de usuários (pode retornar erro caso o usuario já esteja cadastrado)
>>* OBS: Client_id é bloqueado caso esta chamada seja realizada para o mesmo CPF acima de 20 vezes no mesmo dia

## Request body

- SimpleSignup
  - `cpf` string, required — > Document number, only numbers >> Número do documento, apenas números
  - `name` string, required — > Name of user >> Nome do usuário
  - `birthday` string, date, required — > Birhday, format (yyyy-mm-dd) >> Data de nascimento, formato (aaaa-mm-dd)
  - `email` string, required — > Valid email >> Email válido
  - `phone` string, required — > Valid cellphone with DDD, only numbers >> Telefone celular válido com DDD, apenas numeros
  - `zipCode` string, required — > Valid zip code, only numbers >> CEP válido do usuário, apenas números
  - `hasCreditCard` boolean — > Has credit card >> O usuário informou possuir cartão de crédito em seu nome
  - `hasRestriction` boolean — > Has overdue debts >> O usuário informou possuir restrições em seu nome
  - `hasOwnHouse` boolean — > Has own house >> O usuário informou possuir casa própria em seu nome
  - `hasVehicle` boolean — > Has vehicle >> O usuário informou possuir veículo em seu nome
  - `hasAndroid` boolean — > Has android >> O usuário informou possuir celular android em seu nome
  - `logData` LogData
    - `latitude` number, required — Latitude
    - `longitude` number, required — Longitude
    - `occurrenceDate` string, date-time, required — Data da ocorrência, formato (aaaa-MM-dd'T'HH:mm:ss.SSSz)
    - `userAgent` string, required — UserAgent do navegador do usuário
    - `ip` string, required — IP do usuário
    - `mac` string — MAC do usuário

## Response `201`

Pipeline

- Pipeline
  - `id` string — ID do processo
  - `status` 'SIGNUP_ANALISIS' | 'SIGNUP_COMPLETED' | 'SIGNUP_DENIED' | 'PROPOSAL_ANALISIS' | 'PROPOSAL_CREATED' | 'PROPOSAL_DENIED' — Status do processo
  - `cpf` integer — CPF do usuario
  - `name` string — Nome do usuario
  - `dateCreated` string — Data criação do processo
  - `lastUpdated` string — Ultima atualização do processo
  - `matches` Matches[]
    - union
      - MatchLoan
        - `product_id` integer — Id do produto
        - `name` string — Nome do produto
        - `logo` string — Logo do produtoMatchs
        - `minValue` integer — Valor minimo do empréstimo
        - `maxValue` integer — Valor máximo do empréstimo
        - `minInstallment` integer — Quantidade minima de parcelas
        - `maxInstallment` integer — Quantidade máxima de parcelas
        - `monthlyTax` number — Taxa de juros mensal
      - MatchCard
        - `product_id` integer — Id do produto
        - `name` string — Nome do produto
        - `logo` string — Logo do produtoMatchs
        - `annuity` number — Valor da anuidade
        - `network` 'VISA' | 'MASTERCARD' | 'ELO' — Bandeira do Cartão de crédito
      - MatchAuto
        - `product_id` integer — Id do produto
        - `name` string — Nome do produto
        - `logo` string — Logo do produtoMatchs
        - `minValue` integer — Valor minimo do empréstimo
        - `maxValue` integer — Valor máximo do empréstimo
        - `minInstallment` integer — Quantidade minima de parcelas
        - `maxInstallment` integer — Quantidade máxima de parcelas
        - `monthlyTax` number — Taxa de juros mensal
      - MatchHome
        - `product_id` integer — Id do produto
        - `name` string — Nome do produto
        - `logo` string — Logo do produtoMatchs
        - `minValue` integer — Valor minimo do empréstimo
        - `maxValue` integer — Valor máximo do empréstimo
        - `minInstallment` integer — Quantidade minima de parcelas
        - `maxInstallment` integer — Quantidade máxima de parcelas
        - `monthlyTax` number — Taxa de juros mensal
      - MatchFinancingAuto
        - `product_id` integer — Id do produto
        - `name` string — Nome do produto
        - `logo` string — Logo do produtoMatchs
        - `minValue` integer — Valor minimo do empréstimo
        - `maxValue` integer — Valor máximo do empréstimo
        - `minInstallment` integer — Quantidade minima de parcelas
        - `maxInstallment` integer — Quantidade máxima de parcelas
        - `monthlyTax` number — Taxa de juros mensal
      - MatchDebt
        - `product_id` integer — Id do produto
        - `name` string — Nome do produto
        - `logo` string — Logo do produtoMatchs
        - `minValue` integer — Valor minimo do empréstimo
        - `maxValue` integer — Valor máximo do empréstimo
        - `minInstallment` integer — Quantidade minima de parcelas
        - `maxInstallment` integer — Quantidade máxima de parcelas
        - `monthlyTax` number — Taxa de juros mensal
  - `proposals` Proposals[]
    - union
      - Loan
        - `customerServiceNumber` string, required — Número de serviço da solicitação
        - `type` 'LOAN' | 'CARD' | 'REFINANCING_AUTO' | 'REFINANCING_HOME' | 'FINANCING_AUTO' | 'CAAS' | 'WORKING_CAPITAL' | 'DEBT', required — Tipos de produtos disponíveis para o usuário
        - `product` string, required — Nome do produto
        - `product_id` integer, required — Id do produto
        - `hasDocuments` boolean, required — Informa se a proposta já possui os documentos
        - `hasContracts` boolean, required — Informa se a proposta já possui os contrato a ser assinado
        - `logo` string, required — Logo do produto
        - `lastStatus` 'PRE_PROCESSAMENTO' | 'PRE_APROVADO' | 'PENDENTE' | 'AGUARDANDO_DOCUMENTOS' | 'EM_ANALISE_MANUAL' | 'EM_ANALISE_OPERACIONAL' | 'EM_ANALISE_DOCUMENTAL' | 'CONTRATADO' | 'LIBERADO' | 'REPROVADO' | 'ESTORNO' | 'EXPIRADO' | 'APROVADO', required — Estados de análise
        - `pendentDocuments` PendentDocuments[]
        - `dateCreated` string, required — Data da criação da proposta
        - `lastUpdated` string, required — Data da última atualização da proposta
        - `value` number, required — Valor do empréstimo
        - `installments` integer, required — Número de parcelas
        - `monthlyTax` number, required — Taxa de juros mensal
        - `installmentsValue` number — Valor da parcela
        - `iofValue` number — Valor do IOF
        - `grossValue` number — Valor financiado
        - `firstPaymentDate` string — Data da primeira parcela
        - `cet` number — Custo efetivo total anual
        - `releasedDate` string — Data da Liberação do empréstimo
      - Card
        - `customerServiceNumber` string, required — Número de serviço da solicitação
        - `type` 'LOAN' | 'CARD' | 'REFINANCING_AUTO' | 'REFINANCING_HOME' | 'FINANCING_AUTO' | 'CAAS' | 'WORKING_CAPITAL' | 'DEBT', required — Tipos de produtos disponíveis para o usuário
        - `product` string, required — Nome do produto
        - `product_id` integer, required — Id do produto
        - `hasDocuments` boolean, required — Informa se a proposta já possui os documentos
        - `hasContracts` boolean, required — Informa se a proposta já possui os contrato a ser assinado
        - `logo` string, required — Logo do produto
        - `lastStatus` 'PRE_PROCESSAMENTO' | 'PRE_APROVADO' | 'PENDENTE' | 'AGUARDANDO_DOCUMENTOS' | 'EM_ANALISE_MANUAL' | 'EM_ANALISE_OPERACIONAL' | 'EM_ANALISE_DOCUMENTAL' | 'CONTRATADO' | 'LIBERADO' | 'REPROVADO' | 'ESTORNO' | 'EXPIRADO' | 'APROVADO', required — Estados de análise
        - `pendentDocuments` PendentDocuments[]
        - `dateCreated` string, required — Data da criação da proposta
        - `lastUpdated` string, required — Data da última atualização da proposta
        - `international` boolean — Internacional
        - `annuity` number — Valor da anuidade
        - `network` 'VISA' | 'MASTERCARD' | 'ELO' — Bandeira do Cartão de crédito
        - `prepaid` boolean — Cartão pré pago
        - `digitalAccount` boolean — Conta Digital
      - Auto
        - `customerServiceNumber` string, required — Número de serviço da solicitação
        - `type` 'LOAN' | 'CARD' | 'REFINANCING_AUTO' | 'REFINANCING_HOME' | 'FINANCING_AUTO' | 'CAAS' | 'WORKING_CAPITAL' | 'DEBT', required — Tipos de produtos disponíveis para o usuário
        - `product` string, required — Nome do produto
        - `product_id` integer, required — Id do produto
        - `hasDocuments` boolean, required — Informa se a proposta já possui os documentos
        - `hasContracts` boolean, required — Informa se a proposta já possui os contrato a ser assinado
        - `logo` string, required — Logo do produto
        - `lastStatus` 'PRE_PROCESSAMENTO' | 'PRE_APROVADO' | 'PENDENTE' | 'AGUARDANDO_DOCUMENTOS' | 'EM_ANALISE_MANUAL' | 'EM_ANALISE_OPERACIONAL' | 'EM_ANALISE_DOCUMENTAL' | 'CONTRATADO' | 'LIBERADO' | 'REPROVADO' | 'ESTORNO' | 'EXPIRADO' | 'APROVADO', required — Estados de análise
        - `pendentDocuments` PendentDocuments[]
        - `dateCreated` string, required — Data da criação da proposta
        - `lastUpdated` string, required — Data da última atualização da proposta
        - `value` number, required — Valor do empréstimo
        - `installments` integer, required — Número de parcelas
        - `monthlyTax` number, required — Taxa de juros mensal
        - `installmentsValue` number — Valor da parcela
        - `iofValue` number — Valor do IOF
        - `grossValue` number — Valor financiado
        - `firstPaymentDate` string — Data da primeira parcela
        - `cet` number — Custo efetivo total anual
        - `releasedDate` string — Data da Liberação do empréstimo
      - Home
        - `customerServiceNumber` string, required — Número de serviço da solicitação
        - `type` 'LOAN' | 'CARD' | 'REFINANCING_AUTO' | 'REFINANCING_HOME' | 'FINANCING_AUTO' | 'CAAS' | 'WORKING_CAPITAL' | 'DEBT', required — Tipos de produtos disponíveis para o usuário
        - `product` string, required — Nome do produto
        - `product_id` integer, required — Id do produto
        - `hasDocuments` boolean, required — Informa se a proposta já possui os documentos
        - `hasContracts` boolean, required — Informa se a proposta já possui os contrato a ser assinado
        - `logo` string, required — Logo do produto
        - `lastStatus` 'PRE_PROCESSAMENTO' | 'PRE_APROVADO' | 'PENDENTE' | 'AGUARDANDO_DOCUMENTOS' | 'EM_ANALISE_MANUAL' | 'EM_ANALISE_OPERACIONAL' | 'EM_ANALISE_DOCUMENTAL' | 'CONTRATADO' | 'LIBERADO' | 'REPROVADO' | 'ESTORNO' | 'EXPIRADO' | 'APROVADO', required — Estados de análise
        - `pendentDocuments` PendentDocuments[]
        - `dateCreated` string, required — Data da criação da proposta
        - `lastUpdated` string, required — Data da última atualização da proposta
        - `value` number, required — Valor do empréstimo
        - `installments` integer, required — Número de parcelas
        - `monthlyTax` number, required — Taxa de juros mensal
        - `installmentsValue` number — Valor da parcela
        - `iofValue` number — Valor do IOF
        - `grossValue` number — Valor financiado
        - `firstPaymentDate` string — Data da primeira parcela
        - `cet` number — Custo efetivo total anual
        - `releasedDate` string — Data da Liberação do empréstimo
      - FinancingAuto
        - `customerServiceNumber` string, required — Número de serviço da solicitação
        - `type` 'LOAN' | 'CARD' | 'REFINANCING_AUTO' | 'REFINANCING_HOME' | 'FINANCING_AUTO' | 'CAAS' | 'WORKING_CAPITAL' | 'DEBT', required — Tipos de produtos disponíveis para o usuário
        - `product` string, required — Nome do produto
        - `product_id` integer, required — Id do produto
        - `hasDocuments` boolean, required — Informa se a proposta já possui os documentos
        - `hasContracts` boolean, required — Informa se a proposta já possui os contrato a ser assinado
        - `logo` string, required — Logo do produto
        - `lastStatus` 'PRE_PROCESSAMENTO' | 'PRE_APROVADO' | 'PENDENTE' | 'AGUARDANDO_DOCUMENTOS' | 'EM_ANALISE_MANUAL' | 'EM_ANALISE_OPERACIONAL' | 'EM_ANALISE_DOCUMENTAL' | 'CONTRATADO' | 'LIBERADO' | 'REPROVADO' | 'ESTORNO' | 'EXPIRADO' | 'APROVADO', required — Estados de análise
        - `pendentDocuments` PendentDocuments[]
        - `dateCreated` string, required — Data da criação da proposta
        - `lastUpdated` string, required — Data da última atualização da proposta
        - `value` number, required — Valor do empréstimo
        - `installments` integer, required — Número de parcelas
        - `monthlyTax` number, required — Taxa de juros mensal
        - `installmentsValue` number — Valor da parcela
        - `iofValue` number — Valor do IOF
        - `grossValue` number — Valor financiado
        - `firstPaymentDate` string — Data da primeira parcela
        - `cet` number — Custo efetivo total anual
        - `releasedDate` string — Data da Liberação do empréstimo
      - Debt
        - `customerServiceNumber` string, required — Número de serviço da solicitação
        - `type` 'LOAN' | 'CARD' | 'REFINANCING_AUTO' | 'REFINANCING_HOME' | 'FINANCING_AUTO' | 'CAAS' | 'WORKING_CAPITAL' | 'DEBT', required — Tipos de produtos disponíveis para o usuário
        - `product` string, required — Nome do produto
        - `product_id` integer, required — Id do produto
        - `hasDocuments` boolean, required — Informa se a proposta já possui os documentos
        - `hasContracts` boolean, required — Informa se a proposta já possui os contrato a ser assinado
        - `logo` string, required — Logo do produto
        - `lastStatus` 'PRE_PROCESSAMENTO' | 'PRE_APROVADO' | 'PENDENTE' | 'AGUARDANDO_DOCUMENTOS' | 'EM_ANALISE_MANUAL' | 'EM_ANALISE_OPERACIONAL' | 'EM_ANALISE_DOCUMENTAL' | 'CONTRATADO' | 'LIBERADO' | 'REPROVADO' | 'ESTORNO' | 'EXPIRADO' | 'APROVADO', required — Estados de análise
        - `pendentDocuments` PendentDocuments[]
        - `dateCreated` string, required — Data da criação da proposta
        - `lastUpdated` string, required — Data da última atualização da proposta
        - `value` number, required — Valor do empréstimo
        - `installments` integer, required — Número de parcelas
        - `monthlyTax` number, required — Taxa de juros mensal
        - `installmentsValue` number — Valor da parcela
        - `iofValue` number — Valor do IOF
        - `grossValue` number — Valor financiado
        - `firstPaymentDate` string — Data da primeira parcela
        - `cet` number — Custo efetivo total anual
        - `releasedDate` string — Data da Liberação do empréstimo

## Other responses

- `400` — Data validation error
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found
- `409` — Conflict - request can't be executed for user

---

[API](https://skmtc.net/fitbank/apis/onboarding.md) · [All operations](https://skmtc.net/fitbank/apis/onboarding/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fitbank/onboarding/versions/f94d262a8f58/schema)