Coinbax API

Controls

View as Markdown

Verify 2FA code

POST/api/v1/controls/verify-2faX-API-Key

Verify SMS code sent via TwoFactorAuth control

Request body

object

Responses

200Verification result
  • idstringrequired
  • platformIdstringrequired
  • userIdstringrequired
  • typeenumrequired"identity" · "document" · "address" · "phone" · "email"
  • statusenumrequired"pending" · "in_progress" · "approved" · "rejected" · "needs_review" · "expired"
  • levelenumrequired"none" · "basic" · "intermediate" · "advanced"
  • riskRatingenum"low" · "medium" · "high" · "very_high"
  • providerobject
    object
  • externalInquiryIdobject
    object
  • externalSessionTokenobject
    object
  • metadataobject
    object
  • rejectionReasonobject
    object
  • verifiedAtobject
    object
  • expiresAtobject
    object
  • createdAtstring (date-time)required
  • updatedAtstring (date-time)required
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "platformId": "550e8400-e29b-41d4-a716-446655440001",
  "userId": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "type": "identity",
  "status": "approved",
  "level": "basic",
  "riskRating": "low",
  "provider": "persona",
  "externalInquiryId": "inq_ABC123",
  "externalSessionToken": "session_token_xyz",
  "metadata": {
    "email": "user@example.com",
    "country": "US"
  },
  "rejectionReason": null,
  "verifiedAt": "2024-01-15T10:30:00Z",
  "expiresAt": "2025-01-15T10:30:00Z",
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}
curl -X POST https://api-staging.coinbax.com/api/v1/controls/verify-2fa \
  -H "X-API-Key: $COINBAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
const response = await fetch('https://api-staging.coinbax.com/api/v1/controls/verify-2fa', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.COINBAX_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
const result = await response.json();

Verify Twilio SMS code

POST/api/v1/controls/verify-twilio-smsX-API-Key

Verify SMS code sent via TwilioSMS control using Twilio Verify

Request body

object

Responses

200Verification result
  • idstringrequired
  • platformIdstringrequired
  • userIdstringrequired
  • typeenumrequired"identity" · "document" · "address" · "phone" · "email"
  • statusenumrequired"pending" · "in_progress" · "approved" · "rejected" · "needs_review" · "expired"
  • levelenumrequired"none" · "basic" · "intermediate" · "advanced"
  • riskRatingenum"low" · "medium" · "high" · "very_high"
  • providerobject
    object
  • externalInquiryIdobject
    object
  • externalSessionTokenobject
    object
  • metadataobject
    object
  • rejectionReasonobject
    object
  • verifiedAtobject
    object
  • expiresAtobject
    object
  • createdAtstring (date-time)required
  • updatedAtstring (date-time)required
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "platformId": "550e8400-e29b-41d4-a716-446655440001",
  "userId": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "type": "identity",
  "status": "approved",
  "level": "basic",
  "riskRating": "low",
  "provider": "persona",
  "externalInquiryId": "inq_ABC123",
  "externalSessionToken": "session_token_xyz",
  "metadata": {
    "email": "user@example.com",
    "country": "US"
  },
  "rejectionReason": null,
  "verifiedAt": "2024-01-15T10:30:00Z",
  "expiresAt": "2025-01-15T10:30:00Z",
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}
curl -X POST https://api-staging.coinbax.com/api/v1/controls/verify-twilio-sms \
  -H "X-API-Key: $COINBAX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
const response = await fetch('https://api-staging.coinbax.com/api/v1/controls/verify-twilio-sms', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.COINBAX_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
const result = await response.json();