curl --request POST \
  --url https://api.pramaan.dev/v1/capabilities/sms.registration-toll-free.update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "businessName": "Example Bakery",
  "businessWebsite": "https://example.com",
  "businessStreetAddress": "1 Example Street",
  "businessCity": "Example City",
  "businessRegion": "CA",
  "businessPostalCode": "94105",
  "businessCountry": "US",
  "contactFirstName": "Ada",
  "contactLastName": "Example",
  "contactEmail": "ada@example.com",
  "contactPhone": "+14155550100",
  "businessType": "sole_proprietor",
  "useCaseCategories": [
    "account_notifications"
  ],
  "useCaseSummary": "Order updates requested by customers at checkout.",
  "messageSample": "Example Bakery: your order is ready. Reply STOP to opt out.",
  "optInType": "web_form",
  "optInEvidenceUrls": [
    "https://example.com/opt-in.png"
  ],
  "monthlyMessageVolume": "1,000",
  "privacyPolicyUrl": "https://example.com/privacy",
  "termsUrl": "https://example.com/terms",
  "ref": "ref_01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "editReason": "Corrected business website."
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    businessName: 'Example Bakery',
    businessWebsite: 'https://example.com',
    businessStreetAddress: '1 Example Street',
    businessCity: 'Example City',
    businessRegion: 'CA',
    businessPostalCode: '94105',
    businessCountry: 'US',
    contactFirstName: 'Ada',
    contactLastName: 'Example',
    contactEmail: 'ada@example.com',
    contactPhone: '+14155550100',
    businessType: 'sole_proprietor',
    useCaseCategories: ['account_notifications'],
    useCaseSummary: 'Order updates requested by customers at checkout.',
    messageSample: 'Example Bakery: your order is ready. Reply STOP to opt out.',
    optInType: 'web_form',
    optInEvidenceUrls: ['https://example.com/opt-in.png'],
    monthlyMessageVolume: '1,000',
    privacyPolicyUrl: 'https://example.com/privacy',
    termsUrl: 'https://example.com/terms',
    ref: 'ref_01ARZ3NDEKTSV4RRFFQ69G5FAV',
    editReason: 'Corrected business website.'
  })
};

fetch('https://api.pramaan.dev/v1/capabilities/sms.registration-toll-free.update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.pramaan.dev/v1/capabilities/sms.registration-toll-free.update"

payload = {
    "businessName": "Example Bakery",
    "businessWebsite": "https://example.com",
    "businessStreetAddress": "1 Example Street",
    "businessCity": "Example City",
    "businessRegion": "CA",
    "businessPostalCode": "94105",
    "businessCountry": "US",
    "contactFirstName": "Ada",
    "contactLastName": "Example",
    "contactEmail": "ada@example.com",
    "contactPhone": "+14155550100",
    "businessType": "sole_proprietor",
    "useCaseCategories": ["account_notifications"],
    "useCaseSummary": "Order updates requested by customers at checkout.",
    "messageSample": "Example Bakery: your order is ready. Reply STOP to opt out.",
    "optInType": "web_form",
    "optInEvidenceUrls": ["https://example.com/opt-in.png"],
    "monthlyMessageVolume": "1,000",
    "privacyPolicyUrl": "https://example.com/privacy",
    "termsUrl": "https://example.com/terms",
    "ref": "ref_01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "editReason": "Corrected business website."
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "phoneNumber": "<string>",
  "state": "pending",
  "canSend": true,
  "editable": true,
  "editExpiresAt": "<string>"
}

{
  "error": {
    "code": "addendum_required",
    "message": "<string>",
    "next": "<string>",
    "request_id": "<string>",
    "retryable": true,
    "effect": "none",
    "slot": "<string>",
    "required_micro": 123,
    "reason": "balance",
    "plan": "<string>",
    "needs": [
      {
        "kind": "approval",
        "detail": "<string>",
        "step": "<string>"
      }
    ]
  }
}