Submit completed BigDataCorp KYC to Avenia

curl --request POST \
  --url https://api.pods.finance/api/v1/kyc/bigdatacorp/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "address": {
    "state": "SP",
    "city": "Sao Paulo",
    "zipCode": "01001000",
    "streetAddress": "Rua Teste",
    "number": "123",
    "country": "BRA",
    "complement": "Sala 1"
  },
  "phone": "+5511999999999"
}
'

import requests

url = "https://api.pods.finance/api/v1/kyc/bigdatacorp/submit"

payload = {
    "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
    "address": {
        "state": "SP",
        "city": "Sao Paulo",
        "zipCode": "01001000",
        "streetAddress": "Rua Teste",
        "number": "123",
        "country": "BRA",
        "complement": "Sala 1"
    },
    "phone": "+5511999999999"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    kycUserId: '550e8400-e29b-41d4-a716-446655440000',
    address: {
      state: 'SP',
      city: 'Sao Paulo',
      zipCode: '01001000',
      streetAddress: 'Rua Teste',
      number: '123',
      country: 'BRA',
      complement: 'Sala 1'
    },
    phone: '+5511999999999'
  })
};

fetch('https://api.pods.finance/api/v1/kyc/bigdatacorp/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pods.finance/api/v1/kyc/bigdatacorp/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'kycUserId' => '550e8400-e29b-41d4-a716-446655440000',
    'address' => [
        'state' => 'SP',
        'city' => 'Sao Paulo',
        'zipCode' => '01001000',
        'streetAddress' => 'Rua Teste',
        'number' => '123',
        'country' => 'BRA',
        'complement' => 'Sala 1'
    ],
    'phone' => '+5511999999999'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pods.finance/api/v1/kyc/bigdatacorp/submit"

	payload := strings.NewReader("{\n  \"kycUserId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": {\n    \"state\": \"SP\",\n    \"city\": \"Sao Paulo\",\n    \"zipCode\": \"01001000\",\n    \"streetAddress\": \"Rua Teste\",\n    \"number\": \"123\",\n    \"country\": \"BRA\",\n    \"complement\": \"Sala 1\"\n  },\n  \"phone\": \"+5511999999999\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pods.finance/api/v1/kyc/bigdatacorp/submit")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"kycUserId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": {\n    \"state\": \"SP\",\n    \"city\": \"Sao Paulo\",\n    \"zipCode\": \"01001000\",\n    \"streetAddress\": \"Rua Teste\",\n    \"number\": \"123\",\n    \"country\": \"BRA\",\n    \"complement\": \"Sala 1\"\n  },\n  \"phone\": \"+5511999999999\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pods.finance/api/v1/kyc/bigdatacorp/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"kycUserId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": {\n    \"state\": \"SP\",\n    \"city\": \"Sao Paulo\",\n    \"zipCode\": \"01001000\",\n    \"streetAddress\": \"Rua Teste\",\n    \"number\": \"123\",\n    \"country\": \"BRA\",\n    \"complement\": \"Sala 1\"\n  },\n  \"phone\": \"+5511999999999\"\n}"

response = http.request(request)
puts response.read_body

{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "provider_pending"
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

KYC

Submit completed BigDataCorp KYC to Avenia

Finalizes a completed BigDataCorp capture by fetching the provider images and identity data on demand, forwarding them to Avenia, and moving the Pods KYC profile to provider_pending when Avenia accepts the submit. Repeated requests while the Avenia submission is in progress return the existing provider_pending state and do not duplicate document uploads. A durable Pods background task continues to refresh the Avenia attempt after the response. If Avenia rejects the final submit before a normal pending attempt is created, Pods persists the provider failure on the KYC profile as rejected_retryable so GET /api/v1/kyc/status can return providerResult and providerMessage. Pods does not persist full CPF, address, raw images, or base64 payloads.

POST

api

kyc

bigdatacorp

submit

Submit completed BigDataCorp KYC to Avenia

curl --request POST \
  --url https://api.pods.finance/api/v1/kyc/bigdatacorp/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "address": {
    "state": "SP",
    "city": "Sao Paulo",
    "zipCode": "01001000",
    "streetAddress": "Rua Teste",
    "number": "123",
    "country": "BRA",
    "complement": "Sala 1"
  },
  "phone": "+5511999999999"
}
'

import requests

url = "https://api.pods.finance/api/v1/kyc/bigdatacorp/submit"

payload = {
    "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
    "address": {
        "state": "SP",
        "city": "Sao Paulo",
        "zipCode": "01001000",
        "streetAddress": "Rua Teste",
        "number": "123",
        "country": "BRA",
        "complement": "Sala 1"
    },
    "phone": "+5511999999999"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    kycUserId: '550e8400-e29b-41d4-a716-446655440000',
    address: {
      state: 'SP',
      city: 'Sao Paulo',
      zipCode: '01001000',
      streetAddress: 'Rua Teste',
      number: '123',
      country: 'BRA',
      complement: 'Sala 1'
    },
    phone: '+5511999999999'
  })
};

fetch('https://api.pods.finance/api/v1/kyc/bigdatacorp/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pods.finance/api/v1/kyc/bigdatacorp/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'kycUserId' => '550e8400-e29b-41d4-a716-446655440000',
    'address' => [
        'state' => 'SP',
        'city' => 'Sao Paulo',
        'zipCode' => '01001000',
        'streetAddress' => 'Rua Teste',
        'number' => '123',
        'country' => 'BRA',
        'complement' => 'Sala 1'
    ],
    'phone' => '+5511999999999'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pods.finance/api/v1/kyc/bigdatacorp/submit"

	payload := strings.NewReader("{\n  \"kycUserId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": {\n    \"state\": \"SP\",\n    \"city\": \"Sao Paulo\",\n    \"zipCode\": \"01001000\",\n    \"streetAddress\": \"Rua Teste\",\n    \"number\": \"123\",\n    \"country\": \"BRA\",\n    \"complement\": \"Sala 1\"\n  },\n  \"phone\": \"+5511999999999\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pods.finance/api/v1/kyc/bigdatacorp/submit")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"kycUserId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": {\n    \"state\": \"SP\",\n    \"city\": \"Sao Paulo\",\n    \"zipCode\": \"01001000\",\n    \"streetAddress\": \"Rua Teste\",\n    \"number\": \"123\",\n    \"country\": \"BRA\",\n    \"complement\": \"Sala 1\"\n  },\n  \"phone\": \"+5511999999999\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pods.finance/api/v1/kyc/bigdatacorp/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"kycUserId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"address\": {\n    \"state\": \"SP\",\n    \"city\": \"Sao Paulo\",\n    \"zipCode\": \"01001000\",\n    \"streetAddress\": \"Rua Teste\",\n    \"number\": \"123\",\n    \"country\": \"BRA\",\n    \"complement\": \"Sala 1\"\n  },\n  \"phone\": \"+5511999999999\"\n}"

response = http.request(request)
puts response.read_body

{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "provider_pending"
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

{
  "error": {
    "code": "QUOTE_NOT_FOUND",
    "message": "Quote not found or expired"
  }
}

Authorizations

x-api-key

string

header

required

API key for authentication. Obtain from your Pods dashboard.

Body

application/json

Final BigDataCorp KYC submission payload

kycUserId

string<uuid>

required

Pods-generated KYC user id returned by the BigDataCorp session endpoint

Example:

"550e8400-e29b-41d4-a716-446655440000"

address

object

required

Address data forwarded to Avenia during the final BigDataCorp KYC submit. Pods does not persist this address.

Show child attributes

phone

string

Optional applicant phone forwarded to Avenia

Example:

"+5511999999999"

Response

BigDataCorp KYC submitted to Avenia

BigDataCorp KYC submission result

kycUserId

string<uuid>

required

Pods-generated public KYC user id

Example:

"550e8400-e29b-41d4-a716-446655440000"

status

enum<string>

required

Normalized Pods KYC status

Available options:

created,

provider_pending,

approved,

rejected,

rejected_retryable,

blocked

Example:

"provider_pending"

Create BigDataCorp KYC iframe session

Get KYC status