Create a registration
curl --request POST \
--url https://api.fastcac.com/v1/registrations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"external_id": "order-1182",
"proposed_names": [
"Ada Foods Ventures",
"Ada Kitchen Ventures"
],
"line_of_business": "Educational Services And Consultancy",
"business": {
"email": "hello@adafoods.ng",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
},
"proprietors": [
{
"first_name": "Ada",
"last_name": "Obi",
"gender": "female",
"date_of_birth": "1990-04-12",
"nationality": "Nigerian",
"nin": "12345678901",
"email": "ada@example.com",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'order-1182',
proposed_names: ['Ada Foods Ventures', 'Ada Kitchen Ventures'],
line_of_business: 'Educational Services And Consultancy',
business: {
email: 'hello@adafoods.ng',
phone: '08031234567',
address: {
street_number: '12',
street: 'Admiralty Way',
city: 'Lekki',
lga: 'Eti-Osa',
state: 'Lagos',
postcode: '105102'
}
},
proprietors: [
{
first_name: 'Ada',
last_name: 'Obi',
gender: 'female',
date_of_birth: '1990-04-12',
nationality: 'Nigerian',
nin: '12345678901',
email: 'ada@example.com',
phone: '08031234567',
address: {
street_number: '12',
street: 'Admiralty Way',
city: 'Lekki',
lga: 'Eti-Osa',
state: 'Lagos',
postcode: '105102'
}
}
]
})
};
fetch('https://api.fastcac.com/v1/registrations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fastcac.com/v1/registrations"
payload = {
"external_id": "order-1182",
"proposed_names": ["Ada Foods Ventures", "Ada Kitchen Ventures"],
"line_of_business": "Educational Services And Consultancy",
"business": {
"email": "hello@adafoods.ng",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
},
"proprietors": [
{
"first_name": "Ada",
"last_name": "Obi",
"gender": "female",
"date_of_birth": "1990-04-12",
"nationality": "Nigerian",
"nin": "12345678901",
"email": "ada@example.com",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fastcac.com/v1/registrations"
payload := strings.NewReader("{\n \"external_id\": \"order-1182\",\n \"proposed_names\": [\n \"Ada Foods Ventures\",\n \"Ada Kitchen Ventures\"\n ],\n \"line_of_business\": \"Educational Services And Consultancy\",\n \"business\": {\n \"email\": \"hello@adafoods.ng\",\n \"phone\": \"08031234567\",\n \"address\": {\n \"street_number\": \"12\",\n \"street\": \"Admiralty Way\",\n \"city\": \"Lekki\",\n \"lga\": \"Eti-Osa\",\n \"state\": \"Lagos\",\n \"postcode\": \"105102\"\n }\n },\n \"proprietors\": [\n {\n \"first_name\": \"Ada\",\n \"last_name\": \"Obi\",\n \"gender\": \"female\",\n \"date_of_birth\": \"1990-04-12\",\n \"nationality\": \"Nigerian\",\n \"nin\": \"12345678901\",\n \"email\": \"ada@example.com\",\n \"phone\": \"08031234567\",\n \"address\": {\n \"street_number\": \"12\",\n \"street\": \"Admiralty Way\",\n \"city\": \"Lekki\",\n \"lga\": \"Eti-Osa\",\n \"state\": \"Lagos\",\n \"postcode\": \"105102\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fastcac.com/v1/registrations",
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([
'external_id' => 'order-1182',
'proposed_names' => [
'Ada Foods Ventures',
'Ada Kitchen Ventures'
],
'line_of_business' => 'Educational Services And Consultancy',
'business' => [
'email' => 'hello@adafoods.ng',
'phone' => '08031234567',
'address' => [
'street_number' => '12',
'street' => 'Admiralty Way',
'city' => 'Lekki',
'lga' => 'Eti-Osa',
'state' => 'Lagos',
'postcode' => '105102'
]
],
'proprietors' => [
[
'first_name' => 'Ada',
'last_name' => 'Obi',
'gender' => 'female',
'date_of_birth' => '1990-04-12',
'nationality' => 'Nigerian',
'nin' => '12345678901',
'email' => 'ada@example.com',
'phone' => '08031234567',
'address' => [
'street_number' => '12',
'street' => 'Admiralty Way',
'city' => 'Lekki',
'lga' => 'Eti-Osa',
'state' => 'Lagos',
'postcode' => '105102'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"object": "registration",
"id": "reg_4kMzPP2CrSMnY18kiANzau",
"business_id": "biz_68mJv5UBBIPdMGYTvhnrKG",
"external_id": "order-1182",
"type": "business_name",
"status": "draft",
"proposed_names": [
"ADA FOODS VENTURES",
"ADA KITCHEN VENTURES"
],
"line_of_business": "Educational Services And Consultancy",
"business": {
"email": "hello@adafoods.ng",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
},
"proprietors": [
{
"first_name": "Ada",
"last_name": "Obi",
"other_names": null,
"gender": "female",
"date_of_birth": "1990-04-12",
"nationality": "Nigerian",
"nin": "12345678901",
"email": "ada@example.com",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
}
],
"missing_fields": [],
"query": null,
"failure": null,
"registered_name": null,
"registration_number": null,
"certificate_available": false,
"status_report_available": false,
"history": [
{
"from": null,
"to": "draft",
"at": "2026-10-23T22:17:57Z"
}
],
"submitted_at": null,
"approved_at": null,
"created_at": "2026-10-23T22:17:57Z",
"updated_at": "2026-10-23T22:17:57Z"
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "authentication_error",
"code": "api_key_missing",
"message": "Send your API key as `Authorization: Bearer <key>`.",
"param": null,
"request_id": "req_kdwpKsFMKS4VzLjqZJ0ntdrl"
}
}{
"error": {
"type": "permission_error",
"code": "live_mode_unavailable",
"message": "Live registrations aren't open yet. Use a test key (fc_test_…) for now.",
"param": null,
"request_id": "req_oYVCIHqeYbgIA3lIzwG0PO5r"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such registration: reg_0000000000000000000000.",
"param": "id",
"request_id": "req_RlcFqswqrJZos4pnRMH3wa8d"
}
}{
"error": {
"type": "idempotency_error",
"code": "idempotency_key_reused",
"message": "This Idempotency-Key was used for a different request.",
"param": null,
"request_id": "req_rMDN34jrxS4pDxoiY3on5Flb"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>"
}
}Registrations
Create a registration
POST
/
registrations
Create a registration
curl --request POST \
--url https://api.fastcac.com/v1/registrations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"external_id": "order-1182",
"proposed_names": [
"Ada Foods Ventures",
"Ada Kitchen Ventures"
],
"line_of_business": "Educational Services And Consultancy",
"business": {
"email": "hello@adafoods.ng",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
},
"proprietors": [
{
"first_name": "Ada",
"last_name": "Obi",
"gender": "female",
"date_of_birth": "1990-04-12",
"nationality": "Nigerian",
"nin": "12345678901",
"email": "ada@example.com",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
external_id: 'order-1182',
proposed_names: ['Ada Foods Ventures', 'Ada Kitchen Ventures'],
line_of_business: 'Educational Services And Consultancy',
business: {
email: 'hello@adafoods.ng',
phone: '08031234567',
address: {
street_number: '12',
street: 'Admiralty Way',
city: 'Lekki',
lga: 'Eti-Osa',
state: 'Lagos',
postcode: '105102'
}
},
proprietors: [
{
first_name: 'Ada',
last_name: 'Obi',
gender: 'female',
date_of_birth: '1990-04-12',
nationality: 'Nigerian',
nin: '12345678901',
email: 'ada@example.com',
phone: '08031234567',
address: {
street_number: '12',
street: 'Admiralty Way',
city: 'Lekki',
lga: 'Eti-Osa',
state: 'Lagos',
postcode: '105102'
}
}
]
})
};
fetch('https://api.fastcac.com/v1/registrations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.fastcac.com/v1/registrations"
payload = {
"external_id": "order-1182",
"proposed_names": ["Ada Foods Ventures", "Ada Kitchen Ventures"],
"line_of_business": "Educational Services And Consultancy",
"business": {
"email": "hello@adafoods.ng",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
},
"proprietors": [
{
"first_name": "Ada",
"last_name": "Obi",
"gender": "female",
"date_of_birth": "1990-04-12",
"nationality": "Nigerian",
"nin": "12345678901",
"email": "ada@example.com",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fastcac.com/v1/registrations"
payload := strings.NewReader("{\n \"external_id\": \"order-1182\",\n \"proposed_names\": [\n \"Ada Foods Ventures\",\n \"Ada Kitchen Ventures\"\n ],\n \"line_of_business\": \"Educational Services And Consultancy\",\n \"business\": {\n \"email\": \"hello@adafoods.ng\",\n \"phone\": \"08031234567\",\n \"address\": {\n \"street_number\": \"12\",\n \"street\": \"Admiralty Way\",\n \"city\": \"Lekki\",\n \"lga\": \"Eti-Osa\",\n \"state\": \"Lagos\",\n \"postcode\": \"105102\"\n }\n },\n \"proprietors\": [\n {\n \"first_name\": \"Ada\",\n \"last_name\": \"Obi\",\n \"gender\": \"female\",\n \"date_of_birth\": \"1990-04-12\",\n \"nationality\": \"Nigerian\",\n \"nin\": \"12345678901\",\n \"email\": \"ada@example.com\",\n \"phone\": \"08031234567\",\n \"address\": {\n \"street_number\": \"12\",\n \"street\": \"Admiralty Way\",\n \"city\": \"Lekki\",\n \"lga\": \"Eti-Osa\",\n \"state\": \"Lagos\",\n \"postcode\": \"105102\"\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fastcac.com/v1/registrations",
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([
'external_id' => 'order-1182',
'proposed_names' => [
'Ada Foods Ventures',
'Ada Kitchen Ventures'
],
'line_of_business' => 'Educational Services And Consultancy',
'business' => [
'email' => 'hello@adafoods.ng',
'phone' => '08031234567',
'address' => [
'street_number' => '12',
'street' => 'Admiralty Way',
'city' => 'Lekki',
'lga' => 'Eti-Osa',
'state' => 'Lagos',
'postcode' => '105102'
]
],
'proprietors' => [
[
'first_name' => 'Ada',
'last_name' => 'Obi',
'gender' => 'female',
'date_of_birth' => '1990-04-12',
'nationality' => 'Nigerian',
'nin' => '12345678901',
'email' => 'ada@example.com',
'phone' => '08031234567',
'address' => [
'street_number' => '12',
'street' => 'Admiralty Way',
'city' => 'Lekki',
'lga' => 'Eti-Osa',
'state' => 'Lagos',
'postcode' => '105102'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"object": "registration",
"id": "reg_4kMzPP2CrSMnY18kiANzau",
"business_id": "biz_68mJv5UBBIPdMGYTvhnrKG",
"external_id": "order-1182",
"type": "business_name",
"status": "draft",
"proposed_names": [
"ADA FOODS VENTURES",
"ADA KITCHEN VENTURES"
],
"line_of_business": "Educational Services And Consultancy",
"business": {
"email": "hello@adafoods.ng",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
},
"proprietors": [
{
"first_name": "Ada",
"last_name": "Obi",
"other_names": null,
"gender": "female",
"date_of_birth": "1990-04-12",
"nationality": "Nigerian",
"nin": "12345678901",
"email": "ada@example.com",
"phone": "08031234567",
"address": {
"street_number": "12",
"street": "Admiralty Way",
"city": "Lekki",
"lga": "Eti-Osa",
"state": "Lagos",
"postcode": "105102"
}
}
],
"missing_fields": [],
"query": null,
"failure": null,
"registered_name": null,
"registration_number": null,
"certificate_available": false,
"status_report_available": false,
"history": [
{
"from": null,
"to": "draft",
"at": "2026-10-23T22:17:57Z"
}
],
"submitted_at": null,
"approved_at": null,
"created_at": "2026-10-23T22:17:57Z",
"updated_at": "2026-10-23T22:17:57Z"
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>"
}
}{
"error": {
"type": "authentication_error",
"code": "api_key_missing",
"message": "Send your API key as `Authorization: Bearer <key>`.",
"param": null,
"request_id": "req_kdwpKsFMKS4VzLjqZJ0ntdrl"
}
}{
"error": {
"type": "permission_error",
"code": "live_mode_unavailable",
"message": "Live registrations aren't open yet. Use a test key (fc_test_…) for now.",
"param": null,
"request_id": "req_oYVCIHqeYbgIA3lIzwG0PO5r"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such registration: reg_0000000000000000000000.",
"param": "id",
"request_id": "req_RlcFqswqrJZos4pnRMH3wa8d"
}
}{
"error": {
"type": "idempotency_error",
"code": "idempotency_key_reused",
"message": "This Idempotency-Key was used for a different request.",
"param": null,
"request_id": "req_rMDN34jrxS4pDxoiY3on5Flb"
}
}{
"error": {
"type": "invalid_request_error",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"request_id": "<string>"
}
}Authorizations
Your secret API key: fc_test_… in test mode, fc_live_… in live mode.
Body
application/json
Allowed value:
"business_name"Your own reference.
Maximum string length:
255One or two, in order of preference.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Successful Response
reg_…
biz_…, the business this registers.
Your own reference.
Allowed value:
"business_name"Available options:
draft, pending_payment, paid, verification_failed, submitted, queried, approved, rejected One or two, in order of preference, upper case.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
What a draft still needs before submit, as parameter paths.
What CAC asked, once queried.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Once approved.
CAC's Business Name number (seven digits), once approved.
Every status change, oldest first.
Show child attributes
Show child attributes
Allowed value:
"registration"