Skip to main content
POST
/
companies
/
{id}
/
applications
Create company application
curl --request POST \
  --url https://api.rnbi.magent.finance/companies/{id}/applications/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Reap-Version: <reap-version>' \
  --data '
{
  "redirectUri": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "INITIATED",
  "sessionUrl": "<string>",
  "expiresAt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Authorizations

Authorization
string
header
required

API key as Bearer token

Headers

Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14

Path Parameters

id
string<uuid>
required

Unique company identifier

Body

Create company application request

redirectUri
string<uri>
required

URL to redirect to after company verification completes

Response

Company application created successfully

id
string<uuid>
required

Unique company application identifier

companyId
string<uuid>
required

Company this application belongs to

status
enum<string>
required

Application lifecycle status

Available options:
INITIATED,
IN_PROGRESS,
APPROVED,
REJECTED,
REVIEW_REQUIRED,
WORKFLOW_ERROR,
EXPIRED
sessionUrl
string | null
required

URL for the corporate client to complete verification

expiresAt
string | null
required

When the verification session URL expires (ISO 8601)

createdAt
string
required

When the application was created (ISO 8601)

updatedAt
string
required

When the application was last updated (ISO 8601)