Company Registration

Register a company under your integrator account, complete payment, and obtain the API key.

List Available Plans

cURL 
curl https://api.ixblix.app/api/plans \
  -u "int_xxxx:ixblix_integrator_token_xxxx"

Response (array of plans):

Response 
[
  {
    "id": "uuid-of-plan",
    "name": "Starter",
    "billingType": "PERIOD",
    "period": "MONTHLY",
    "priceCents": 4900,
    "currency": "BRL",
    "isActive": true,
    "isPublic": true,
    "createdAt": "2026-01-01T00:00:00.000Z"
  }
]

Register a Company

cURL 
curl -X POST https://api.ixblix.app/api/companies/register \
  -u "int_xxxx:ixblix_integrator_token_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corporation",
    "planId": "plan_starter"
  }'

Request Fields

FieldRequiredDescription
nameYesDisplay name of the company.
planIdYesID of a subscription plan.

The response includes company and payment with a checkoutUrl — redirect the company owner there to complete payment.

Response 
{
  "company": { "id": "cmp_xxxx", "name": "Acme Corporation", "status": "PENDING_PAYMENT" },
  "payment": {
    "transactionId": "company_cmp_xxxx-txn",
    "provider": "efi",
    "amountCents": 4900,
    "currency": "BRL",
    "confirmationUrl": "/api/companies/cmp_xxxx/activate/company_cmp_xxxx-txn",
    "status": "PENDING",
    "checkoutUrl": "https://api.ixblix.app/checkout/company_cmp_xxxx-txn"
  }
}

Activate the Company

After payment confirmation:

cURL 
curl -X POST https://api.ixblix.app/api/companies/{companyId}/activate/{transactionId} \
  -u "int_xxxx:ixblix_integrator_token_xxxx"

Response:

Response 
{
  "apiKey": "smci_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "ACTIVE"
}

Important: The apiKey is shown only once. Store it securely.

Billing Types

TypeDescription
MESSAGESCharged per message sent or received.
CONVERSATIONSCharged per conversation created.
COMPANYFlat fee per company.
TIMETime-based access (e.g., monthly).
← Previous Integrator Registration