AgentLLC

API Reference

Base URL: https://api.agentllc.dev

Authentication

All API requests require a Bearer token in the Authorization header.

curl https://api.agentllc.dev/v1/orders \
  -H "Authorization: Bearer ak_live_your_key_here"

Create an order

POST /v1/orders

{
  "type": "llc",
  "company_name_en": "My Company LLC",
  "legal_address": "Tbilisi, Georgia",
  "company_email": "[email protected]",
  "activity_codes": ["62.01"],
  "shareholders": [
    {
      "full_name": "Jane Smith",
      "nationality": "US",
      "passport_number": "123456789",
      "date_of_birth": "1990-01-15",
      "ownership_pct": 100
    }
  ],
  "directors": [
    {
      "full_name": "Jane Smith",
      "nationality": "US",
      "passport_number": "123456789"
    }
  ]
}

For LLC + bank account, set type: "llc_bank" and include bank_prefs.

Create a payment link

Once an order exists, create a hosted NOWPayments checkout link for that order.

POST /v1/orders/:id/pay

// Response
{
  "id": "pay_xxx",
  "provider": "nowpayments",
  "status": "pending",
  "hosted_url": "https://nowpayments.io/payment/?iid=..."
}

After successful payment, the order advances from draft to documents_pending.

Order statuses

draftOrder created, not yet confirmed
documents_pendingAwaiting document uploads
documents_receivedAll documents received
under_reviewOperator reviewing documents
poa_requiredPower of Attorney needed
poa_receivedPoA received
submitted_to_naprFiled at NAPR
registeredLLC registered, certificate available
bank_pendingBank account requested
bank_in_progressBank processing
completedEverything done

Webhooks

Register a URL to receive order.status_changed events. Each delivery is signed with HMAC-SHA256.

POST /v1/webhooks
{
  "url": "https://your-app.com/webhooks/agentllc",
  "events": ["order.status_changed"]
}

// Response includes a secret (shown once):
// "secret": "whsec_abc123..."

// Verify with the X-AgentLLC-Signature header

Other endpoints

GET/v1/ordersList your orders
GET/v1/orders/:idGet order details
PATCH/v1/orders/:idUpdate order (before submission)
POST/v1/orders/:id/cancelCancel order
POST/v1/orders/:id/payCreate a hosted payment link
POST/v1/orders/:id/documentsUpload document
GET/v1/orders/:id/documentsList documents
GET/v1/pricingCurrent pricing
GET/v1/healthHealth check