Create BigDataCorp KYC iframe session

curl --request POST \
  --url https://api.pods.finance/api/v1/kyc/bigdatacorp/sessions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "cpf": "52998224725",
  "email": "[email protected]",
  "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268",
  "externalUserId": "app-user-001",
  "restartExistingSession": true
}
'

import requests

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

payload = {
    "cpf": "52998224725",
    "email": "[email protected]",
    "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268",
    "externalUserId": "app-user-001",
    "restartExistingSession": True
}
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({
    cpf: '52998224725',
    email: '[email protected]',
    walletAddress: '0xb794F5eA0ba39494cE839613fffBA74279579268',
    externalUserId: 'app-user-001',
    restartExistingSession: true
  })
};

fetch('https://api.pods.finance/api/v1/kyc/bigdatacorp/sessions', 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/sessions",
  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([
    'cpf' => '52998224725',
    'email' => '[email protected]',
    'walletAddress' => '0xb794F5eA0ba39494cE839613fffBA74279579268',
    'externalUserId' => 'app-user-001',
    'restartExistingSession' => true
  ]),
  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/sessions"

	payload := strings.NewReader("{\n  \"cpf\": \"52998224725\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\",\n  \"externalUserId\": \"app-user-001\",\n  \"restartExistingSession\": true\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/sessions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"cpf\": \"52998224725\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\",\n  \"externalUserId\": \"app-user-001\",\n  \"restartExistingSession\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"cpf\": \"52998224725\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\",\n  \"externalUserId\": \"app-user-001\",\n  \"restartExistingSession\": true\n}"

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

{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "iframeUrl": "https://iframe.bigdatacorp.com.br/550e8400-e29b-41d4-a716-446655440000",
  "iframeSessionId": "bigdatacorp-onboarding-id",
  "requiresWebView": true,
  "status": "created"
}

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

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

KYC

Create BigDataCorp KYC iframe session

Starts the BigDataCorp document and liveness capture flow. Pods creates a KYC profile with provider bigdatacorp, stores only safe references and CPF hash/last4, and returns the iframe URL plus the Pods-generated kycUserId. Requests reuse an active capture for up to seven minutes unless restartExistingSession is true, which creates a fresh iframe session in the same KYC profile. If the verified CPF maps to exactly one approved local BigDataCorp KYC profile or approved Avenia identity, Pods creates a customer-scoped approved profile from the existing Avenia IDs without starting a new capture. The response provides a safe completion URL and requiresWebView false for mobile compatibility. Otherwise, Pods can perform a bounded Avenia lookup while the CPF is present in this request.

POST

api

kyc

bigdatacorp

sessions

Create BigDataCorp KYC iframe session

curl --request POST \
  --url https://api.pods.finance/api/v1/kyc/bigdatacorp/sessions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "cpf": "52998224725",
  "email": "[email protected]",
  "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268",
  "externalUserId": "app-user-001",
  "restartExistingSession": true
}
'

import requests

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

payload = {
    "cpf": "52998224725",
    "email": "[email protected]",
    "walletAddress": "0xb794F5eA0ba39494cE839613fffBA74279579268",
    "externalUserId": "app-user-001",
    "restartExistingSession": True
}
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({
    cpf: '52998224725',
    email: '[email protected]',
    walletAddress: '0xb794F5eA0ba39494cE839613fffBA74279579268',
    externalUserId: 'app-user-001',
    restartExistingSession: true
  })
};

fetch('https://api.pods.finance/api/v1/kyc/bigdatacorp/sessions', 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/sessions",
  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([
    'cpf' => '52998224725',
    'email' => '[email protected]',
    'walletAddress' => '0xb794F5eA0ba39494cE839613fffBA74279579268',
    'externalUserId' => 'app-user-001',
    'restartExistingSession' => true
  ]),
  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/sessions"

	payload := strings.NewReader("{\n  \"cpf\": \"52998224725\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\",\n  \"externalUserId\": \"app-user-001\",\n  \"restartExistingSession\": true\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/sessions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"cpf\": \"52998224725\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\",\n  \"externalUserId\": \"app-user-001\",\n  \"restartExistingSession\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"cpf\": \"52998224725\",\n  \"email\": \"[email protected]\",\n  \"walletAddress\": \"0xb794F5eA0ba39494cE839613fffBA74279579268\",\n  \"externalUserId\": \"app-user-001\",\n  \"restartExistingSession\": true\n}"

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

{
  "kycUserId": "550e8400-e29b-41d4-a716-446655440000",
  "iframeUrl": "https://iframe.bigdatacorp.com.br/550e8400-e29b-41d4-a716-446655440000",
  "iframeSessionId": "bigdatacorp-onboarding-id",
  "requiresWebView": true,
  "status": "created"
}

{
  "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

BigDataCorp iframe session creation payload

cpf

string

required

Brazilian CPF. Pods normalizes and hashes this value; the full CPF is not persisted.

Example:

"52998224725"

string<email>

required

Applicant email

Example:

"[email protected]"

walletAddress

string

required

Applicant EVM wallet address

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

externalUserId

string

Optional id from your system for support correlation

Example:

"app-user-001"

restartExistingSession

boolean

When true, always create a fresh BigDataCorp iframe session for this KYC profile. Use this when retrying or remounting a mobile WebView that may cache an earlier iframe URL.

Example:

true

Response

BigDataCorp iframe session created, reused, or resolved as an approved reusable identity

BigDataCorp session result. Requests reuse an active capture for up to seven minutes unless restartExistingSession is true, which creates a fresh iframe session in the same KYC profile. An approved Avenia identity reuse returns status approved, a safe completion iframe URL, null iframeSessionId, and requiresWebView false. Poll the returned kycUserId through the canonical status endpoint.

kycUserId

string<uuid>

required

Pods-generated public KYC user id

Example:

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

iframeUrl

string<uri>

required

BigDataCorp iframe URL for document and liveness capture. When capture is not needed because an approved Avenia identity was reused, Pods returns a safe completion URL instead of null for mobile WebView compatibility.

Example:

"https://iframe.bigdatacorp.com.br/550e8400-e29b-41d4-a716-446655440000"

iframeSessionId

string | null

required

Current BigDataCorp onboarding id. Use it as the WebView remount key so a cached iframe cannot be displayed after Pods returns a newer session. Null when no capture is needed.

Example:

"bigdatacorp-onboarding-id"

requiresWebView

boolean

required

Whether the client must mount the returned iframe URL for BigDataCorp capture.

Example:

true

status

enum<string>

required

Normalized Pods KYC status

Available options:

created,

provider_pending,

approved,

rejected,

rejected_retryable,

blocked

Example:

"created"

Import Sumsub reusable KYC share token

Submit completed BigDataCorp KYC to Avenia

Overview

Health

Swap

Tracking

Strategies

Ondo

Tokens

Transfer

Wallets

Smart Account

KYC

Create BigDataCorp KYC iframe session

Authorizations

Body

Response