{
  "schemaVersion": "1.0",
  "item": {
    "slug": "twilio",
    "name": "Twilio",
    "category": "finance-and-operations",
    "description": "Twilio Console exposes billing-group invoices, payment receipts, usage statements, and CSV supplements for reconciling usage-based communications charges.",
    "status": "researched",
    "website": "https://www.twilio.com/",
    "invoiceHelpUrl": "https://help.twilio.com/articles/360036601993",
    "apiDocumentationUrl": "https://www.twilio.com/docs/usage/api/usage-record",
    "accessMethods": [
      "official_api",
      "vendor_portal",
      "email_forward",
      "manual_upload"
    ],
    "authentication": {
      "oauth": false,
      "apiToken": false,
      "browserSession": true,
      "requiredRole": "Twilio user with access to Account Billing for the billing group"
    },
    "capabilities": {
      "accountDiscovery": {
        "supported": "partial",
        "notes": "Billing groups can consolidate accounts and subaccounts, but Billproof does not connect to them directly."
      },
      "billingHistory": {
        "supported": true,
        "notes": "Bill History provides historical invoice PDF and CSV exports."
      },
      "invoiceMetadata": {
        "supported": true
      },
      "invoicePdf": {
        "supported": true
      },
      "creditNotes": {
        "supported": "unknown"
      },
      "lineItems": {
        "supported": true,
        "notes": "PDF invoices and CSV supplements provide product and usage detail."
      },
      "usage": {
        "supported": true,
        "notes": "The Console and Usage API expose usage data programmatically."
      },
      "subscriptions": {
        "supported": "partial",
        "notes": "Twilio mixes usage-based products with account and contract billing."
      },
      "paymentMethod": {
        "supported": true
      }
    },
    "billing": {
      "cadence": [
        "monthly",
        "usage based",
        "contract dependent"
      ],
      "invoiceLocation": "Twilio Console > Admin > Account billing > Bill History or Billing Overview.",
      "emailedAutomatically": "unknown",
      "currencies": [],
      "documentTypes": [
        "PDF invoice",
        "CSV invoice supplement",
        "PDF receipt",
        "usage statement"
      ]
    },
    "billproof": {
      "retrieval": "partial",
      "normalization": "partial",
      "transactionMatching": "partial",
      "connectionAvailable": false,
      "limitations": [
        "No direct Twilio billing connection is available in Billproof.",
        "The official Usage API can support cost analysis but does not replace the invoice document.",
        "Billing groups can consolidate multiple accounts and subaccounts into a single invoice.",
        "Twilio states that subaccount usage is not broken down in the account's PDF invoice; use the CSV supplement or usage tools.",
        "Rounding can cause fractional-cent differences between invoices, Console usage, and the Usage API."
      ]
    },
    "normalizedFields": [
      "vendor_name",
      "invoice_number",
      "invoice_date",
      "billing_period",
      "billing_group_id",
      "account_sid",
      "subaccount_sid",
      "product_category",
      "usage_quantity",
      "unit_price",
      "line_items",
      "subtotal",
      "tax",
      "total",
      "currency",
      "payment_status"
    ],
    "commonCardDescriptors": [],
    "guide": {
      "quickAnswer": "Open Twilio Console > Admin > Account billing > Bill History, then download the invoice PDF and CSV supplement for the required billing period.",
      "requiredRole": "Twilio user with access to Account Billing for the billing group",
      "steps": [
        "Sign in to Twilio Console and select an account associated with the correct billing group.",
        "Open Admin > Account billing.",
        "Open Bill History or the Billing Overview invoice area.",
        "Choose the required monthly invoice and download its PDF.",
        "Download the CSV supplement when product, subaccount, or detailed usage reconciliation is needed.",
        "Use Usage Summary or the Usage API to investigate timing and category variances without treating estimates as the invoice document."
      ],
      "historyLocation": "Twilio Console > Admin > Account billing > Bill History.",
      "missingInvoice": "Confirm the selected account belongs to the expected billing group and that the user has billing access; check whether the account is pay-as-you-go or invoiced, then contact Twilio Support if Bill History is incomplete.",
      "formats": [
        "PDF invoice",
        "CSV invoice supplement",
        "PDF receipt",
        "usage statement"
      ],
      "commonProblems": [
        "The wrong account or billing group is selected.",
        "A payment receipt is used in place of the usage invoice.",
        "Subaccount detail is sought in the PDF instead of the CSV supplement.",
        "Fractional-cent rounding differences are treated as a missing charge."
      ],
      "matchingTips": [
        "Match billing group, invoice period, and invoice total first.",
        "Use account and subaccount IDs from detailed usage exports to allocate shared costs.",
        "Allow for documented rounding differences when comparing Usage API totals with final invoice lines."
      ]
    },
    "researchedAt": "2026-08-28",
    "lastVerifiedAt": "2026-08-28",
    "sources": [
      {
        "title": "Billing",
        "url": "https://www.twilio.com/docs/usage/billing",
        "type": "official"
      },
      {
        "title": "How to Find My Twilio Invoice",
        "url": "https://help.twilio.com/articles/360036601993",
        "type": "official"
      },
      {
        "title": "How to Read your Twilio Invoice",
        "url": "https://help.twilio.com/articles/360025603913",
        "type": "official"
      },
      {
        "title": "Usage Records API",
        "url": "https://www.twilio.com/docs/usage/api/usage-record",
        "type": "official"
      }
    ],
    "statusLabel": "Billing guide available",
    "cta": "Request this integration",
    "manualGuide": "https://billproof.io/guides/find-twilio-invoices",
    "urls": {
      "html": "https://billproof.io/integrations/twilio",
      "json": "https://billproof.io/api/public/vendors/twilio.json",
      "capabilities": "https://billproof.io/api/public/vendors/twilio/capabilities.json"
    }
  }
}