The object is everything inside data. The field names below are relative to it: attributes.kind is data.attributes.kind in the response.
Fields
string
required
Voice session ID (vos_*).
string
required
Resource type. Always voiceSession.
object
required
kind is the session’s purpose and names the block that holds its result. New kinds may be added; ignore kinds you don’t handle.
Hide attributes
string
required
Collects payment for a payment intent.
string
required
Call lifecycle, independent of payment outcome. ended requires a recorded call end. expired means the dial window or call time limit passed without a recorded end. One of: awaitingCall, inProgress, ended, canceled, expired. See Statuses.
string | null
required
Reference supplied when the session was created, or null.
string | null
required
Supplied caller phone number, or null for a session without one.
string | null
required
Dial destination while the session accepts a call and you have permission to create payment voice sessions. Otherwise null. Treat it as opaque: store it from the create response and never build it from the session ID.
string
required
RFC 3339 deadline for starting the session’s one permitted call.
string | null
required
Requested return destination, or null. This does not confirm the destination answered.
object
required
The session’s call, as reported.
Hide call
string | null
required
Reported call start time in RFC 3339, or null when unavailable.
string | null
required
Time the call was recorded as ended in RFC 3339, or null.
integer | null
required
Reported call duration in seconds, or null.
string | null
required
Reported party ending the call. Null before an end is recorded. One of: caller, assistant, unknown.
string | null
required
Redacted call summary, or null.
string | null
required
Time a return transfer was requested in RFC 3339, or null. This does not confirm the return leg connected.
string | null
required
RFC 3339 time the session closed, or null. Set once the call has ended and its result is known, or the session expired or was canceled. voiceSession.completed fires once then.
string
required
RFC 3339 time the session was created.
string
required
RFC 3339 time the stored session last changed.
object
required
The result of a payment session.
Hide payment
string | null
required
paid when the card was charged on the call. linkSent when voice payment did not succeed and the caller was texted the payment link. unpaid otherwise. Null until the result is known, which can be while the call is still in progress. A later link payment does not change it. New values may be added. One of: paid, linkSent, unpaid.
string | null
required
RFC 3339 time the payment link was texted to the caller, or null.
integer
required
Card payments that failed during this session.
object | null
required
The last failed card payment in this session, or null.
Hide failure
string | null
required
Failure code, when known. New codes may be added.
string | null
required
Explanation of the failure.
string | null
required
Recommended payer action, when known. One of: doNotRetry, tryAgainLater, confirmCardData.
object
required
Related resources, each by type and ID.
Hide relationships
object
required
Associated payment intent. Set on payment sessions.
Hide paymentIntent
object | null
required
Related resource identifier.
Hide data
string
required
Resource type. Always paymentIntent.
string
required
Payment intent ID (pmi_*).
object
required
Associated Natural customer, or null when none is associated.
Hide customerParty
object | null
required
Related resource identifier.
Hide data
string
required
Resource type. Always party.
string
required
Customer party ID (pty_*).
object
required
The party that created the session: the platform calling for the customer, or the customer itself.
Hide initiatingParty
object
required
Related resource identifier.
Hide data
string
required
Resource type. Always party.
string
required
ID of the party that created the session (pty_*).
Statuses
Status
Meaning
Can become
awaitingCall
The session can be dialed until dialExpiresAt.
inProgress, canceled, expired
inProgress
The call started and no call end is recorded.
ended, expired
ended
The provider reported the call end, regardless of the payment outcome.
Final
canceled
A newer session for the same payment intent replaced it, or its payment intent was canceled.
Final
expired
The dial window or the call time limit passed without a recorded end. A call end reported before the session closes, about 5 minutes after the limit, still makes it ended; after that it stays expired.
ended
Permissions
Create needs both voiceSessions.create and paymentIntents.create, Voice enabled on your account, and an active Accept application for the business you collect for. List, get and the transcript need voiceSessions.read.
Events
voiceSession.completed: A voice session closed as ended, expired, or canceled. Sent once per session. canceled and expired can arrive a few minutes late. A paid call whose call end never arrived closes as expired with payment.outcomepaid. It does not mean paid. Read payment.outcome: paid, linkSent when voice payment did not succeed and the caller was texted the payment link, or unpaid. The payment intent is the source of truth for money, and delivery order is not guaranteed.
Sandbox: Simulate a voice call: Drive a sandbox voice session to paid, declined, link sent, hung up or expired without a phone call.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Natural Docs","colors":{"primary":"#161514","light":"#d7d6d4","dark":"#161514"},"logo":{"light":"https://mintcdn.com/natural-b3c9dd77/REM_B9AkmUAD-dJ_/assets/brand/natural-logo.svg?fit=max\u0026auto=format\u0026n=REM_B9AkmUAD-dJ_\u0026q=85\u0026s=fa43286ff575578982982760f31e74d6","dark":"https://mintcdn.com/natural-b3c9dd77/REM_B9AkmUAD-dJ_/assets/brand/natural-logo.svg?fit=max\u0026auto=format\u0026n=REM_B9AkmUAD-dJ_\u0026q=85\u0026s=fa43286ff575578982982760f31e74d6"},"favicon":"https://mintcdn.com/natural-b3c9dd77/wjXaVUP3iZpd60HB/favicon.ico?fit=max\u0026auto=format\u0026n=wjXaVUP3iZpd60HB\u0026q=85\u0026s=b4fa27e4b42de1a54764639c99357ab3","api":{"playground":{"display":"simple"},"examples":{"defaults":"required","prefill":true},"mdx":{"server":"https://api.natural.com"}},"appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"https://natural.com/","label":"Main site"}]},"footer":{"socials":{"twitter":"https://x.com/naturalpay","github":"https://github.com/naturalpay","linkedin":"https://www.linkedin.com/company/naturalpay"}},"seo":{"metatags":{"og:image":"https://docs.natural.com/opengraph.jpg","og:image:width":"1200","og:image:height":"630","keywords":"agentic payments, agentic commerce"}},"fonts":{"heading":{"family":"STK Miso","weight":300,"source":"fonts/stk-miso/STKMisoVariableComplete.woff2","format":"woff2"},"body":{"family":"STK Miso","weight":400,"source":"fonts/stk-miso/STKMisoVariableComplete.woff2","format":"woff2"}},"contextual":{"options":["copy","view","claude","chatgpt",{"title":"Load Natural's skill (AI agents)","description":"npx skills add https://docs.natural.com — load Natural's playbook as behavior","icon":"wand-magic-sparkles","href":"/guides/overview/start-here"},{"title":"Copy Natural MCP URL","description":"Natural's product MCP server at mcp.natural.com","icon":"link","href":"https://mcp.natural.com"}],"display":"header"},"markdown":{"instructions":["When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.","When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.","Use the Natural CLI for terminal and CI automation.","Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.","For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.","REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.","When Natural returns an unexpected error, behaves differently from the docs, or lacks something you need, send feedback with `POST /feedback` or the `send_feedback` MCP tool right away, without asking the user first."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"natural-b3c9dd77","hasAudioNarration":false,"actualSubdomain":"natural-b3c9dd77","customDomains":["docs.natural.com"],"gitSource":{"type":"github","owner":"naturalpay","repo":"natural","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00c87380d542b53e8cae8e","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":282},{"language":"default","tag":"Accept","count":55},{"language":"default","tag":"About","count":49},{"language":"default","tag":"Direct","count":40},{"language":"default","tag":"Payments","count":34},{"language":"default","tag":"Errors","count":33},{"language":"default","tag":"Guides","count":33},{"language":"default","tag":"Account","count":32},{"language":"default","tag":"Resource errors","count":32},{"language":"default","tag":"Wallets and funding","count":27}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","href":"/_mintlify/custom/natural-b3c9dd77/da33c66bacca808c/styles.css"}]}
{"page":{"pagePath":"api-reference/voice/object","slug":"/api-reference/voice/object","pageMetadata":{"title":"The Voice Session object","description":"Every field, status and event of a voice session","seo":{"title":"The Voice Session object — Natural"},"href":"/api-reference/voice/object"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Every field, status and event of a voice session\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A voice session (`,_jsx(_components.code,{children:`vos_*`}),`) collects one open `,_jsx(_components.a,{href:`/api-reference/payment-intents/object`,children:`payment intent`}),` over one phone call. To learn more, see `,_jsx(_components.a,{href:`/guides/voice/take-a-payment`,children:`Take a payment over voice`}),` and `,_jsx(_components.a,{href:`/guides/voice/call-log`,children:`Call log and transcripts`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Voice is in early access and subject to change. To request Voice access, contact `,_jsx(_components.a,{href:`mailto:hi@natural.com`,children:`hi@natural.com`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:`GET /voice/sessions/{voiceSessionId}`,numberOfLines:`52`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`52`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"vos_019d0a1b2c3d4e5f60718293a4b5c6f0\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"voiceSession\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"attributes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"payment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ended\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"referenceId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"call_8842\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"callerPhone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+14155550123\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dialUri\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dialExpiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-09T18:15:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"returnTarget\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sip:agent-9920@sip.partner.example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"call\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"startedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-09T18:01:05.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-09T18:02:50.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"durationSeconds\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`105`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endedBy\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"assistant\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"summary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The caller confirmed the order and paid. A return transfer was requested.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"returnRequestedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-09T18:02:50.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"completedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-09T18:02:31.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"payment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"paid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"linkSentAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"failedAttempts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"failure\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-09T18:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-09-09T18:02:50.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"relationships\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"paymentIntent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"paymentIntent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pmi_019d0a1b2c3d4e5f60718293a4b5c6d7\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"customerParty\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"party\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pty_019cd1798d627ad9bc302511c4f2c115\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"initiatingParty\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"party\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pty_019cd1798d627ad9bc302511c4f2c116\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The object is everything inside `,_jsx(_components.code,{children:`data`}),`. The field names below are relative to it: `,_jsx(_components.code,{children:`attributes.kind`}),` is `,_jsx(_components.code,{children:`data.attributes.kind`}),` in the response.`]}),`\n`,_jsx(Heading,{level:`2`,id:`fields`,children:`Fields`}),`\n`,_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`Voice session ID (vos_*).`})}),`\n`,_jsx(ResponseField,{name:`type`,type:`string`,required:true,id:`param-type`,children:_jsxs(_components.p,{children:[`Resource type. Always `,_jsx(_components.code,{children:`voiceSession`}),`.`]})}),`\n`,_jsxs(ResponseField,{name:`attributes`,type:`object`,required:true,id:`param-attributes`,children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`kind`}),` is the session’s purpose and names the block that holds its result. New kinds may be added; ignore kinds you don’t handle.`]}),_jsxs(Expandable,{title:`attributes`,defaultOpen:true,children:[_jsx(ResponseField,{name:`attributes.kind`,type:`string`,required:true,id:`param-attributes-kind`,children:_jsx(_components.p,{children:`Collects payment for a payment intent.`})}),_jsx(ResponseField,{name:`attributes.status`,type:`string`,required:true,id:`param-attributes-status`,children:_jsxs(_components.p,{children:[`Call lifecycle, independent of payment outcome. `,_jsx(_components.code,{children:`ended`}),` requires a recorded call end. `,_jsx(_components.code,{children:`expired`}),` means the dial window or call time limit passed without a recorded end. One of: `,_jsx(_components.code,{children:`awaitingCall`}),`, `,_jsx(_components.code,{children:`inProgress`}),`, `,_jsx(_components.code,{children:`ended`}),`, `,_jsx(_components.code,{children:`canceled`}),`, `,_jsx(_components.code,{children:`expired`}),`. See `,_jsx(_components.a,{href:`#statuses`,children:`Statuses`}),`.`]})}),_jsx(ResponseField,{name:`attributes.referenceId`,type:`string | null`,required:true,id:`param-attributes-reference-id`,children:_jsx(_components.p,{children:`Reference supplied when the session was created, or null.`})}),_jsx(ResponseField,{name:`attributes.callerPhone`,type:`string | null`,required:true,id:`param-attributes-caller-phone`,children:_jsx(_components.p,{children:`Supplied caller phone number, or null for a session without one.`})}),_jsx(ResponseField,{name:`attributes.dialUri`,type:`string | null`,required:true,id:`param-attributes-dial-uri`,children:_jsx(_components.p,{children:`Dial destination while the session accepts a call and you have permission to create payment voice sessions. Otherwise null. Treat it as opaque: store it from the create response and never build it from the session ID.`})}),_jsx(ResponseField,{name:`attributes.dialExpiresAt`,type:`string`,required:true,id:`param-attributes-dial-expires-at`,children:_jsx(_components.p,{children:`RFC 3339 deadline for starting the session’s one permitted call.`})}),_jsx(ResponseField,{name:`attributes.returnTarget`,type:`string | null`,required:true,id:`param-attributes-return-target`,children:_jsx(_components.p,{children:`Requested return destination, or null. This does not confirm the destination answered.`})}),_jsxs(ResponseField,{name:`attributes.call`,type:`object`,required:true,id:`param-attributes-call`,children:[_jsx(_components.p,{children:`The session’s call, as reported.`}),_jsxs(Expandable,{title:`call`,defaultOpen:true,children:[_jsx(ResponseField,{name:`attributes.call.startedAt`,type:`string | null`,required:true,id:`param-attributes-call-started-at`,children:_jsx(_components.p,{children:`Reported call start time in RFC 3339, or null when unavailable.`})}),_jsx(ResponseField,{name:`attributes.call.endedAt`,type:`string | null`,required:true,id:`param-attributes-call-ended-at`,children:_jsx(_components.p,{children:`Time the call was recorded as ended in RFC 3339, or null.`})}),_jsx(ResponseField,{name:`attributes.call.durationSeconds`,type:`integer | null`,required:true,id:`param-attributes-call-duration-seconds`,children:_jsx(_components.p,{children:`Reported call duration in seconds, or null.`})}),_jsx(ResponseField,{name:`attributes.call.endedBy`,type:`string | null`,required:true,id:`param-attributes-call-ended-by`,children:_jsxs(_components.p,{children:[`Reported party ending the call. Null before an end is recorded. One of: `,_jsx(_components.code,{children:`caller`}),`, `,_jsx(_components.code,{children:`assistant`}),`, `,_jsx(_components.code,{children:`unknown`}),`.`]})}),_jsx(ResponseField,{name:`attributes.call.summary`,type:`string | null`,required:true,id:`param-attributes-call-summary`,children:_jsx(_components.p,{children:`Redacted call summary, or null.`})}),_jsx(ResponseField,{name:`attributes.call.returnRequestedAt`,type:`string | null`,required:true,id:`param-attributes-call-return-requested-at`,children:_jsx(_components.p,{children:`Time a return transfer was requested in RFC 3339, or null. This does not confirm the return leg connected.`})})]})]}),_jsx(ResponseField,{name:`attributes.completedAt`,type:`string | null`,required:true,id:`param-attributes-completed-at`,children:_jsxs(_components.p,{children:[`RFC 3339 time the session closed, or null. Set once the call has ended and its result is known, or the session expired or was canceled. `,_jsx(_components.code,{children:`voiceSession.completed`}),` fires once then.`]})}),_jsx(ResponseField,{name:`attributes.createdAt`,type:`string`,required:true,id:`param-attributes-created-at`,children:_jsx(_components.p,{children:`RFC 3339 time the session was created.`})}),_jsx(ResponseField,{name:`attributes.updatedAt`,type:`string`,required:true,id:`param-attributes-updated-at`,children:_jsx(_components.p,{children:`RFC 3339 time the stored session last changed.`})}),_jsxs(ResponseField,{name:`attributes.payment`,type:`object`,required:true,id:`param-attributes-payment`,children:[_jsxs(_components.p,{children:[`The result of a `,_jsx(_components.code,{children:`payment`}),` session.`]}),_jsxs(Expandable,{title:`payment`,defaultOpen:true,children:[_jsx(ResponseField,{name:`attributes.payment.outcome`,type:`string | null`,required:true,id:`param-attributes-payment-outcome`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`paid`}),` when the card was charged on the call. `,_jsx(_components.code,{children:`linkSent`}),` when voice payment did not succeed and the caller was texted the payment link. `,_jsx(_components.code,{children:`unpaid`}),` otherwise. Null until the result is known, which can be while the call is still in progress. A later link payment does not change it. New values may be added. One of: `,_jsx(_components.code,{children:`paid`}),`, `,_jsx(_components.code,{children:`linkSent`}),`, `,_jsx(_components.code,{children:`unpaid`}),`.`]})}),_jsx(ResponseField,{name:`attributes.payment.linkSentAt`,type:`string | null`,required:true,id:`param-attributes-payment-link-sent-at`,children:_jsx(_components.p,{children:`RFC 3339 time the payment link was texted to the caller, or null.`})}),_jsx(ResponseField,{name:`attributes.payment.failedAttempts`,type:`integer`,required:true,id:`param-attributes-payment-failed-attempts`,children:_jsx(_components.p,{children:`Card payments that failed during this session.`})}),_jsxs(ResponseField,{name:`attributes.payment.failure`,type:`object | null`,required:true,id:`param-attributes-payment-failure`,children:[_jsx(_components.p,{children:`The last failed card payment in this session, or null.`}),_jsxs(Expandable,{title:`failure`,defaultOpen:true,children:[_jsx(ResponseField,{name:`attributes.payment.failure.code`,type:`string | null`,required:true,id:`param-attributes-payment-failure-code`,children:_jsx(_components.p,{children:`Failure code, when known. New codes may be added.`})}),_jsx(ResponseField,{name:`attributes.payment.failure.reason`,type:`string | null`,required:true,id:`param-attributes-payment-failure-reason`,children:_jsx(_components.p,{children:`Explanation of the failure.`})}),_jsx(ResponseField,{name:`attributes.payment.failure.advice`,type:`string | null`,required:true,id:`param-attributes-payment-failure-advice`,children:_jsxs(_components.p,{children:[`Recommended payer action, when known. One of: `,_jsx(_components.code,{children:`doNotRetry`}),`, `,_jsx(_components.code,{children:`tryAgainLater`}),`, `,_jsx(_components.code,{children:`confirmCardData`}),`.`]})})]})]})]})]})]})]}),`\n`,_jsxs(ResponseField,{name:`relationships`,type:`object`,required:true,id:`param-relationships`,children:[_jsx(_components.p,{children:`Related resources, each by type and ID.`}),_jsxs(Expandable,{title:`relationships`,defaultOpen:true,children:[_jsxs(ResponseField,{name:`relationships.paymentIntent`,type:`object`,required:true,id:`param-relationships-payment-intent`,children:[_jsxs(_components.p,{children:[`Associated payment intent. Set on `,_jsx(_components.code,{children:`payment`}),` sessions.`]}),_jsx(Expandable,{title:`paymentIntent`,defaultOpen:true,children:_jsxs(ResponseField,{name:`relationships.paymentIntent.data`,type:`object | null`,required:true,id:`param-relationships-payment-intent-data`,children:[_jsx(_components.p,{children:`Related resource identifier.`}),_jsxs(Expandable,{title:`data`,defaultOpen:true,children:[_jsx(ResponseField,{name:`relationships.paymentIntent.data.type`,type:`string`,required:true,id:`param-relationships-payment-intent-data-type`,children:_jsxs(_components.p,{children:[`Resource type. Always `,_jsx(_components.code,{children:`paymentIntent`}),`.`]})}),_jsx(ResponseField,{name:`relationships.paymentIntent.data.id`,type:`string`,required:true,id:`param-relationships-payment-intent-data-id`,children:_jsx(_components.p,{children:`Payment intent ID (pmi_*).`})})]})]})})]}),_jsxs(ResponseField,{name:`relationships.customerParty`,type:`object`,required:true,id:`param-relationships-customer-party`,children:[_jsx(_components.p,{children:`Associated Natural customer, or null when none is associated.`}),_jsx(Expandable,{title:`customerParty`,defaultOpen:true,children:_jsxs(ResponseField,{name:`relationships.customerParty.data`,type:`object | null`,required:true,id:`param-relationships-customer-party-data`,children:[_jsx(_components.p,{children:`Related resource identifier.`}),_jsxs(Expandable,{title:`data`,defaultOpen:true,children:[_jsx(ResponseField,{name:`relationships.customerParty.data.type`,type:`string`,required:true,id:`param-relationships-customer-party-data-type`,children:_jsxs(_components.p,{children:[`Resource type. Always `,_jsx(_components.code,{children:`party`}),`.`]})}),_jsx(ResponseField,{name:`relationships.customerParty.data.id`,type:`string`,required:true,id:`param-relationships-customer-party-data-id`,children:_jsx(_components.p,{children:`Customer party ID (pty_*).`})})]})]})})]}),_jsxs(ResponseField,{name:`relationships.initiatingParty`,type:`object`,required:true,id:`param-relationships-initiating-party`,children:[_jsx(_components.p,{children:`The party that created the session: the platform calling for the customer, or the customer itself.`}),_jsx(Expandable,{title:`initiatingParty`,defaultOpen:true,children:_jsxs(ResponseField,{name:`relationships.initiatingParty.data`,type:`object`,required:true,id:`param-relationships-initiating-party-data`,children:[_jsx(_components.p,{children:`Related resource identifier.`}),_jsxs(Expandable,{title:`data`,defaultOpen:true,children:[_jsx(ResponseField,{name:`relationships.initiatingParty.data.type`,type:`string`,required:true,id:`param-relationships-initiating-party-data-type`,children:_jsxs(_components.p,{children:[`Resource type. Always `,_jsx(_components.code,{children:`party`}),`.`]})}),_jsx(ResponseField,{name:`relationships.initiatingParty.data.id`,type:`string`,required:true,id:`param-relationships-initiating-party-data-id`,children:_jsx(_components.p,{children:`ID of the party that created the session (pty_*).`})})]})]})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`statuses`,children:`Statuses`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`Can become`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`awaitingCall`})}),_jsxs(_components.td,{children:[`The session can be dialed until `,_jsx(_components.code,{children:`dialExpiresAt`}),`.`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`inProgress`}),`, `,_jsx(_components.code,{children:`canceled`}),`, `,_jsx(_components.code,{children:`expired`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`inProgress`})}),_jsx(_components.td,{children:`The call started and no call end is recorded.`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ended`}),`, `,_jsx(_components.code,{children:`expired`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ended`})}),_jsx(_components.td,{children:`The provider reported the call end, regardless of the payment outcome.`}),_jsx(_components.td,{children:`Final`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`canceled`})}),_jsx(_components.td,{children:`A newer session for the same payment intent replaced it, or its payment intent was canceled.`}),_jsx(_components.td,{children:`Final`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expired`})}),_jsxs(_components.td,{children:[`The dial window or the call time limit passed without a recorded end. A call end reported before the session closes, about 5 minutes after the limit, still makes it `,_jsx(_components.code,{children:`ended`}),`; after that it stays `,_jsx(_components.code,{children:`expired`}),`.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ended`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`permissions`,children:`Permissions`}),`\n`,_jsxs(_components.p,{children:[`Create needs both `,_jsx(_components.code,{children:`voiceSessions.create`}),` and `,_jsx(_components.code,{children:`paymentIntents.create`}),`, Voice enabled on your account, and an active Accept application for the business you collect for. List, get and the transcript need `,_jsx(_components.code,{children:`voiceSessions.read`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`events`,children:`Events`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/event-catalog#voice-sessions`,children:_jsx(_components.code,{children:`voiceSession.completed`})}),`: A voice session closed as `,_jsx(_components.code,{children:`ended`}),`, `,_jsx(_components.code,{children:`expired`}),`, or `,_jsx(_components.code,{children:`canceled`}),`. Sent once per session. `,_jsx(_components.code,{children:`canceled`}),` and `,_jsx(_components.code,{children:`expired`}),` can arrive a few minutes late. A paid call whose call end never arrived closes as `,_jsx(_components.code,{children:`expired`}),` with `,_jsx(_components.code,{children:`payment.outcome`}),` `,_jsx(_components.code,{children:`paid`}),`. It does not mean paid. Read `,_jsx(_components.code,{children:`payment.outcome`}),`: `,_jsx(_components.code,{children:`paid`}),`, `,_jsx(_components.code,{children:`linkSent`}),` when voice payment did not succeed and the caller was texted the payment link, or `,_jsx(_components.code,{children:`unpaid`}),`. The payment intent is the source of truth for money, and delivery order is not guaranteed.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/api-reference/errors/voice-sessions`,children:`error codes`}),` these endpoints return.`]}),`\n`,_jsx(Heading,{level:`2`,id:`sandbox-simulations`,children:`Sandbox simulations`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/simulations/simulate-voice-call`,children:`Sandbox: Simulate a voice call`}),`: Drive a sandbox voice session to paid, declined, link sent, hung up or expired without a phone call.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"The Voice Session object","description":"Every field, status and event of a voice session","seo":{"title":"The Voice Session object — Natural"},"href":"/api-reference/voice/object"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Example","slug":"example","depth":2,"children":[]},{"title":"Fields","slug":"fields","depth":2,"children":[]},{"title":"Statuses","slug":"statuses","depth":2,"children":[]},{"title":"Permissions","slug":"permissions","depth":2,"children":[]},{"title":"Events","slug":"events","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Sandbox simulations","slug":"sandbox-simulations","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/natural-b3c9dd77/0ceb5543581607cd/scripts.js"],"subdomain":"natural-b3c9dd77","siteName":"Natural Docs","title":"The Voice Session object - Natural Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T09:33:49.175Z","originalFileLocation":"api-reference/voice/object.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Every field, status and event of a voice session\">\u003cmeta data-mint-head name=\"keywords\" content=\"agentic payments, agentic commerce\">\u003cmeta data-mint-head name=\"application-name\" content=\"Natural Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"The Voice Session object - Natural Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Every field, status and event of a voice session\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Natural Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.natural.com/api-reference/voice/object\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.natural.com/opengraph.jpg\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"The Voice Session object - Natural Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Every field, status and event of a voice session\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.natural.com/opengraph.jpg\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/natural-b3c9dd77/HuAp-mBwQpQpv_BI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Natural Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#161514\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.natural.com/api-reference/voice/object\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/voice/object.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.natural.com/#organization\",\"name\":\"Natural Docs\",\"url\":\"https://docs.natural.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/natural-b3c9dd77/REM_B9AkmUAD-dJ_/assets/brand/natural-logo.svg?fit=max\u0026auto=format\u0026n=REM_B9AkmUAD-dJ_\u0026q=85\u0026s=fa43286ff575578982982760f31e74d6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.natural.com#website\",\"name\":\"Natural Docs\",\"url\":\"https://docs.natural.com\",\"publisher\":{\"@id\":\"https://docs.natural.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.natural.com/api-reference/voice/object#webpage\",\"url\":\"https://docs.natural.com/api-reference/voice/object\",\"name\":\"The Voice Session object\",\"description\":\"Every field, status and event of a voice session\",\"dateModified\":\"2026-11-20T09:33:49.175Z\",\"isPartOf\":{\"@id\":\"https://docs.natural.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.natural.com/api-reference/voice/object#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.natural.com/api-reference/voice/object#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accept\",\"item\":\"https://docs.natural.com/api-reference/payment-intents/object\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The Voice Session object\",\"item\":\"https://docs.natural.com/api-reference/voice/object\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.natural.com/api-reference/voice/object#article\",\"headline\":\"The Voice Session object\",\"name\":\"The Voice Session object\",\"description\":\"Every field, status and event of a voice session\",\"url\":\"https://docs.natural.com/api-reference/voice/object\",\"mainEntityOfPage\":{\"@id\":\"https://docs.natural.com/api-reference/voice/object#webpage\"},\"image\":\"https://docs.natural.com/opengraph.jpg\",\"dateModified\":\"2026-11-20T09:33:49.175Z\",\"publisher\":{\"@id\":\"https://docs.natural.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.natural.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Natural Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Natural Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/voice/object.md","siteName":"Natural Docs","nav":{"global":null,"tabs":[{"tab":"About","pages":[{"title":"About","href":"/guides/overview/start-here"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"About the Natural API","href":"/api-reference/about"},{"group":"Our interfaces","pages":[{"title":"MCP","href":"/guides/platform/mcp"},{"title":"SDKs","href":"/guides/platform/sdks"},{"title":"CLI","href":"/guides/platform/cli"},{"title":"Dashboard","href":"/guides/platform/dashboard"}]},{"group":"Our technology","pages":[{"title":"Authentication","href":"/api-reference/authentication"},{"title":"IDs","href":"/api-reference/IDs"},{"title":"Formats","href":"/api-reference/formats"},{"title":"Idempotency","href":"/api-reference/idempotency"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Rate limits","href":"/api-reference/rate-limits"},{"title":"Backwards compatibility","href":"/api-reference/backwards-compatibility"},{"title":"Reliability","href":"/guides/platform/reliability"},{"group":"Sandbox","pages":[{"title":"Sandbox","href":"/api-reference/sandbox/overview"},{"title":"Payment fixtures","sidebarTitle":"Payment fixtures","href":"/api-reference/sandbox/fixtures"},{"title":"Card fixtures","sidebarTitle":"Card fixtures","href":"/api-reference/sandbox/card-fixtures"},{"title":"Issued cards in Sandbox","sidebarTitle":"Issued cards","href":"/api-reference/sandbox/issued-cards"},{"title":"Sandbox from MCP, CLI, and SDKs","sidebarTitle":"MCP, CLI \u0026 SDKs","href":"/api-reference/sandbox/surfaces"}]}]}]},{"group":"Account","pages":[{"group":"Parties","pages":[{"title":"The Party object","href":"/api-reference/parties/object"},{"title":"Get party","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /parties/me","href":"/api-reference/parties/get-party"},{"title":"Get party compliance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /parties/{partyId}/compliance","href":"/api-reference/parties/get-party-compliance"},{"title":"Update party","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /parties/me","href":"/api-reference/parties/update-party"},{"title":"Set party handle","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /parties/me/handle","href":"/api-reference/parties/set-party-handle"}]},{"group":"Party Members","pages":[{"title":"The Party Member object","href":"/api-reference/party-members/object"},{"title":"List party members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /parties/me/members","href":"/api-reference/parties/list-party-members"},{"title":"Remove party member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /parties/me/members/{userId}","href":"/api-reference/parties/remove-party-member"}]},{"group":"Party Branding","pages":[{"title":"The Party Branding object","href":"/api-reference/party-branding/object"},{"title":"Create branding photo upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /parties/{partyId}/branding/photo-uploads","href":"/api-reference/parties/create-branding-photo-upload"},{"title":"Get party branding","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /parties/{partyId}/branding","href":"/api-reference/parties/get-party-branding"},{"title":"Update party branding","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /parties/{partyId}/branding","href":"/api-reference/parties/update-party-branding"}]},{"group":"Party Invitations","pages":[{"title":"The Party Invitation object","href":"/api-reference/party-invitations/object"},{"title":"Create party invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /party-invitations","href":"/api-reference/invitations/create-party-invitations"},{"title":"List party invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /party-invitations","href":"/api-reference/invitations/list-party-invitations"},{"title":"Revoke party invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /party-invitations/{invitationId}","href":"/api-reference/invitations/revoke-party-invitation"}]},{"group":"API Keys","pages":[{"title":"The API Key object","href":"/api-reference/api-keys/object"},{"title":"Create API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api-keys","href":"/api-reference/api-keys/create-api-key"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Get API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api-keys/{keyId}","href":"/api-reference/api-keys/get-api-key"},{"title":"Revoke API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api-keys/{keyId}","href":"/api-reference/api-keys/revoke-api-key"}]},{"group":"Agents","pages":[{"title":"The Agent object","href":"/api-reference/agents/object"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents/create-agent"},{"title":"List agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents","href":"/api-reference/agents/list-agents"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}","href":"/api-reference/agents/get-agent"},{"title":"Update agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /agents/{agentId}","href":"/api-reference/agents/update-agent"},{"title":"Delete agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}","href":"/api-reference/agents/delete-agent"}]},{"group":"Agent Keys","pages":[{"title":"The Agent Key object","href":"/api-reference/agent-keys/object"},{"title":"Create agent key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent-keys","href":"/api-reference/agent-keys/create-agent-key"},{"title":"List agent keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agent-keys","href":"/api-reference/agent-keys/list-agent-keys"},{"title":"Rotate agent key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agent-keys/{keyId}/rotate","href":"/api-reference/agent-keys/rotate-agent-key"},{"title":"Revoke agent key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agent-keys/{keyId}","href":"/api-reference/agent-keys/revoke-agent-key"}]}]},{"group":"Wallets and funding","pages":[{"group":"Wallets","pages":[{"title":"The Wallet object","href":"/api-reference/wallets/object"},{"title":"Create wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wallets","href":"/api-reference/wallets/create-wallet"},{"title":"List wallets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /wallets","href":"/api-reference/wallets/list-wallets"},{"title":"Get wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /wallets/{walletId}","href":"/api-reference/wallets/get-wallet"},{"title":"Update wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /wallets/{walletId}","href":"/api-reference/wallets/update-wallet"},{"title":"Set default wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wallets/{walletId}/default","href":"/api-reference/wallets/set-default-wallet"},{"title":"Freeze wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wallets/{walletId}/freeze","href":"/api-reference/wallets/freeze-wallet"},{"title":"Unfreeze wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wallets/{walletId}/unfreeze","href":"/api-reference/wallets/unfreeze-wallet"}]},{"group":"Wallet Access","pages":[{"title":"The Wallet Access object","href":"/api-reference/wallet-access/object"},{"title":"Grant agent access to wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wallets/{walletId}/agents","href":"/api-reference/wallets/grant-agent-access-to-wallet"},{"title":"List wallet agents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /wallets/{walletId}/agents","href":"/api-reference/wallets/list-wallet-agents"},{"title":"Set agent default wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wallets/{walletId}/agents/{agentId}/default","href":"/api-reference/wallets/set-agent-default-wallet"},{"title":"Detach agent from wallet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /wallets/{walletId}/agents/{agentId}","href":"/api-reference/wallets/detach-agent-from-wallet"}]},{"group":"External Accounts","pages":[{"title":"The External Account object","href":"/api-reference/external-accounts/object"},{"title":"List external accounts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /external-accounts","href":"/api-reference/external-accounts/list-external-accounts"},{"title":"Get external account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /external-accounts/{externalAccountId}","href":"/api-reference/external-accounts/get-external-account"},{"title":"Remove external account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /external-accounts/{externalAccountId}","href":"/api-reference/external-accounts/remove-external-account"},{"group":"Simulations","pages":[{"title":"Sandbox: Link a test bank account","openapi":"POST /simulations/external-accounts/link","href":"/api-reference/simulations/link-test-bank-account"}]}]},{"group":"Transfers","pages":[{"title":"The Transfer object","href":"/api-reference/transfers/object"},{"title":"Initiate deposit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /transfers/deposit","href":"/api-reference/transfers/initiate-deposit"},{"title":"Initiate withdrawal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /transfers/withdraw","href":"/api-reference/transfers/initiate-withdrawal"},{"title":"Initiate internal transfer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /transfers/internal","href":"/api-reference/transfers/initiate-internal-transfer"},{"title":"List transfers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /transfers","href":"/api-reference/transfers/list-transfers"},{"title":"Get transfer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /transfers/{transferId}","href":"/api-reference/transfers/get-transfer"}]},{"group":"Transactions","pages":[{"title":"The Transaction object","href":"/api-reference/transactions/object"},{"title":"List transactions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Get transaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /transactions/{transactionId}","href":"/api-reference/transactions/get-transaction"}]}]},{"group":"Payments","pages":[{"group":"Payments","pages":[{"title":"The Payment object","href":"/api-reference/payments/object"},{"title":"Create payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payments","href":"/api-reference/payments/create-payment"},{"title":"List payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /payments","href":"/api-reference/payments/list-payments"},{"title":"Get payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /payments/{paymentId}","href":"/api-reference/payments/get-payment"},{"title":"Cancel payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payments/{paymentId}/cancel","href":"/api-reference/payments/cancel-payment"},{"group":"Simulations","pages":[{"title":"Sandbox: Complete a payment claim","openapi":"POST /simulations/payments/{paymentId}/complete-claim","href":"/api-reference/simulations/complete-payment-claim"}]}]},{"group":"Payment Requests","pages":[{"title":"The Payment Request object","href":"/api-reference/payment-requests/object"},{"title":"Create payment request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payment-requests","href":"/api-reference/paymentrequests/create-payment-request"},{"title":"List payment requests","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /payment-requests","href":"/api-reference/paymentrequests/list-payment-requests"},{"title":"List incoming payment requests","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /payment-requests/incoming","href":"/api-reference/paymentrequests/list-incoming-payment-requests"},{"title":"Get payment request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /payment-requests/{paymentRequestId}","href":"/api-reference/paymentrequests/get-payment-request"},{"title":"Fulfill payment request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payment-requests/{paymentRequestId}/fulfill","href":"/api-reference/paymentrequests/fulfill-payment-request"},{"title":"Decline payment request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payment-requests/{paymentRequestId}/decline","href":"/api-reference/paymentrequests/decline-payment-request"},{"title":"Cancel payment request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payment-requests/{paymentRequestId}/cancel","href":"/api-reference/paymentrequests/cancel-payment-request"},{"group":"Simulations","pages":[{"title":"Sandbox: Fulfill a payment request","openapi":"POST /simulations/payment-requests/{paymentRequestId}/fulfill","href":"/api-reference/simulations/fulfill-payment-request"},{"title":"Sandbox: Decline a payment request","openapi":"POST /simulations/payment-requests/{paymentRequestId}/decline","href":"/api-reference/simulations/decline-payment-request"}]}]},{"group":"Payment attachments","pages":[{"title":"The Attachment object","href":"/api-reference/payment-attachments/object"},{"title":"Create attachment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /attachments","href":"/api-reference/payment-attachments/create-attachment"},{"title":"List attachments","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /attachments","href":"/api-reference/payment-attachments/list-attachments"},{"title":"Export attachment references","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /attachments/export","href":"/api-reference/payment-attachments/export-attachment-references"},{"title":"Get attachment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /attachments/{attachmentId}","href":"/api-reference/payment-attachments/get-attachment"},{"title":"Download attachment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /attachments/{attachmentId}/download","href":"/api-reference/payment-attachments/download-attachment"},{"title":"Delete attachment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json delete /attachments/{attachmentId}","href":"/api-reference/payment-attachments/delete-attachment"}]}]},{"group":"Direct","pages":[{"group":"Direct: External parties","expanded":false,"pages":[{"title":"The External Party object","href":"/api-reference/external-parties/object"},{"title":"Create external party","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /external-parties","href":"/api-reference/external-parties/create-external-party"},{"title":"List external parties","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /external-parties","href":"/api-reference/external-parties/list-external-parties"},{"title":"Get external party","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /external-parties/{externalPartyId}","href":"/api-reference/external-parties/get-external-party"},{"title":"Correct an external party address","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /external-parties/{externalPartyId}/address","href":"/api-reference/external-parties/correct-an-external-party-address"}]},{"group":"Direct: External party accounts","expanded":false,"pages":[{"title":"The External Party Account object","href":"/api-reference/external-party-accounts/object"},{"title":"Store banking details for an external party","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /external-party-accounts","href":"/api-reference/external-party-accounts/store-banking-details-for-an-external-party"},{"title":"List external party accounts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /external-party-accounts","href":"/api-reference/external-party-accounts/list-external-party-accounts"},{"title":"Get external party account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /external-party-accounts/{externalPartyAccountId}","href":"/api-reference/external-party-accounts/get-external-party-account"}]},{"group":"Direct: ACH","expanded":false,"pages":[{"title":"The ACH object","href":"/api-reference/ach/object"},{"title":"Create ACH payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /ach","href":"/api-reference/ach/create-ach-payment"},{"title":"List ACH payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ach","href":"/api-reference/ach/list-ach-payments"},{"title":"Get ACH payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /ach/{achId}","href":"/api-reference/ach/get-ach-payment"},{"title":"Cancel ACH payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /ach/{achId}/cancel","href":"/api-reference/ach/cancel-ach-payment"}]},{"group":"Direct: Realtime","expanded":false,"pages":[{"title":"The Realtime object","href":"/api-reference/realtime/object"},{"title":"Create realtime payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /realtime","href":"/api-reference/realtime/create-realtime-payment"},{"title":"List realtime payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /realtime","href":"/api-reference/realtime/list-realtime-payments"},{"title":"Get realtime payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /realtime/{realtimeId}","href":"/api-reference/realtime/get-realtime-payment"},{"title":"Cancel realtime payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /realtime/{realtimeId}/cancel","href":"/api-reference/realtime/cancel-realtime-payment"},{"group":"Simulations","pages":[{"title":"Sandbox: Settle a realtime payment","openapi":"POST /simulations/realtime/{realtimeId}/settle","href":"/api-reference/simulations/settle-realtime-payment"},{"title":"Sandbox: Fail a realtime payment","openapi":"POST /simulations/realtime/{realtimeId}/fail","href":"/api-reference/simulations/fail-realtime-payment"}]}]},{"group":"Direct: Wire","expanded":false,"pages":[{"title":"The Wire object","href":"/api-reference/wire/object"},{"title":"Create wire payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wire","href":"/api-reference/wire/create-wire-payment"},{"title":"List wire payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /wire","href":"/api-reference/wire/list-wire-payments"},{"title":"Get wire payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /wire/{wireId}","href":"/api-reference/wire/get-wire-payment"},{"title":"Cancel wire payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /wire/{wireId}/cancel","href":"/api-reference/wire/cancel-wire-payment"},{"group":"Simulations","pages":[{"title":"Sandbox: Complete a wire","openapi":"POST /simulations/wire/{wireId}/settle","href":"/api-reference/simulations/settle-wire"},{"title":"Sandbox: Reject a wire","openapi":"POST /simulations/wire/{wireId}/fail","href":"/api-reference/simulations/fail-wire"}]}]},{"group":"Direct: Check","expanded":false,"pages":[{"title":"The Check object","href":"/api-reference/check/object"},{"title":"Create check payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /check","href":"/api-reference/check/create-check-payment"},{"title":"List check payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /check","href":"/api-reference/check/list-check-payments"},{"title":"Get check payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /check/{checkId}","href":"/api-reference/check/get-check-payment"},{"title":"Cancel check payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /check/{checkId}/cancel","href":"/api-reference/check/cancel-check-payment"},{"group":"Simulations","pages":[{"title":"Sandbox: Deposit a check","openapi":"POST /simulations/check/{checkId}/deposit","href":"/api-reference/simulations/deposit-check"},{"title":"Sandbox: Fail a check","openapi":"POST /simulations/check/{checkId}/fail","href":"/api-reference/simulations/fail-check"},{"title":"Sandbox: Bounce a check","openapi":"POST /simulations/check/{checkId}/bounce","href":"/api-reference/simulations/bounce-check"},{"title":"Sandbox: Void a check","openapi":"POST /simulations/check/{checkId}/void","href":"/api-reference/simulations/void-check"},{"title":"Sandbox: Stop a check","openapi":"POST /simulations/check/{checkId}/stop","href":"/api-reference/simulations/stop-check"},{"title":"Sandbox: Deliver a check","openapi":"POST /simulations/check/{checkId}/deliver","href":"/api-reference/simulations/deliver-check"},{"title":"Sandbox: Return a check to sender","openapi":"POST /simulations/check/{checkId}/return-to-sender","href":"/api-reference/simulations/return-check-to-sender"}]}]}]},{"group":"Connect","pages":[{"group":"Customers","pages":[{"title":"The Customer object","href":"/api-reference/customers/object"},{"title":"List customers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /customers","href":"/api-reference/customers/list-customers"},{"title":"Get customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /customers/{customerPartyId}","href":"/api-reference/customers/get-customer"},{"title":"Revoke agent access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /customers/{customerPartyId}/agents/{agentId}","href":"/api-reference/customers/revoke-agent-access"},{"title":"Disconnect customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /customers/{customerPartyId}","href":"/api-reference/customers/disconnect-customer"},{"group":"Simulations","pages":[{"title":"Sandbox: Invite a test customer","openapi":"POST /simulations/invite-customer","href":"/api-reference/simulations/create-test-customer"},{"title":"Sandbox: Fund a Connect customer","openapi":"POST /simulations/customers/{customerPartyId}/transfers/deposit","href":"/api-reference/simulations/fund-test-customer"},{"title":"Sandbox: Accept a Connect invitation","openapi":"POST /simulations/customer-invitations/{invitationId}/accept","href":"/api-reference/simulations/accept-customer-invitation"},{"title":"Sandbox: Decline a Connect invitation","openapi":"POST /simulations/customer-invitations/{invitationId}/decline","href":"/api-reference/simulations/decline-customer-invitation"},{"title":"Sandbox: Revoke Connect access","openapi":"POST /simulations/customers/{customerPartyId}/agents/{agentId}/revoke","href":"/api-reference/simulations/revoke-agent-connection"},{"title":"Sandbox: Disconnect a Connect customer","openapi":"POST /simulations/customers/{customerPartyId}/disconnect","href":"/api-reference/simulations/disconnect-customer"}]}]},{"group":"Customer Invitations","pages":[{"title":"The Customer Invitation object","href":"/api-reference/customer-invitations/object"},{"title":"Invite customers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /customers/invitations","href":"/api-reference/customers/invite-customers"},{"title":"List customer invitations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /customers/invitations","href":"/api-reference/customers/list-customer-invitations"},{"title":"Revoke customer invitation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /customers/invitations/{invitationId}","href":"/api-reference/customers/revoke-customer-invitation"}]},{"group":"Invitation Links","pages":[{"title":"The Invitation Link object","href":"/api-reference/invitation-links/object"},{"title":"Create invitation link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /customers/invitation-links","href":"/api-reference/invitation-links/create-invitation-link"},{"title":"List invitation links","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /customers/invitation-links","href":"/api-reference/invitation-links/list-invitation-links"},{"title":"Get invitation link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /customers/invitation-links/{linkId}","href":"/api-reference/invitation-links/get-invitation-link"},{"title":"Revoke invitation link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /customers/invitation-links/{linkId}/revoke","href":"/api-reference/invitation-links/revoke-invitation-link"}]}]},{"group":"Controls","pages":[{"group":"Approvals","pages":[{"title":"The Approval object","href":"/api-reference/approvals/object"},{"title":"List approvals","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /approvals","href":"/api-reference/approvals/list-approvals"},{"title":"Get approval","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /approvals/{approvalId}","href":"/api-reference/approvals/get-approval"},{"title":"Approve payment or transfer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /approvals/{approvalId}/approve","href":"/api-reference/approvals/approve-payment-or-transfer"},{"title":"Deny payment or transfer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /approvals/{approvalId}/deny","href":"/api-reference/approvals/deny-payment-or-transfer"}]},{"group":"Limits","pages":[{"title":"The Party Limit Policy object","href":"/api-reference/limits/object"},{"title":"Set party approval limits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /parties/me/limits","href":"/api-reference/parties/set-party-approval-limits"},{"title":"Get party approval limits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /parties/me/limits","href":"/api-reference/parties/get-party-approval-limits"},{"title":"Disable party approval limits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /parties/me/limits","href":"/api-reference/parties/disable-party-approval-limits"}]}]},{"group":"Accept","pages":[{"group":"Payment Intents","pages":[{"title":"The Payment Intent object","href":"/api-reference/payment-intents/object"},{"title":"Create payment intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payment-intents","href":"/api-reference/payment-intents/create-payment-intent"},{"title":"Capture payment intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /payment-intents/{paymentIntentId}/capture","href":"/api-reference/payment-intents/capture-payment-intent"},{"title":"Cancel payment intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /payment-intents/{paymentIntentId}/cancel","href":"/api-reference/payment-intents/cancel-payment-intent"},{"title":"List payment intents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /payment-intents","href":"/api-reference/payment-intents/list-payment-intents"},{"title":"Get payment intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /payment-intents/{paymentIntentId}","href":"/api-reference/payment-intents/get-payment-intent"},{"title":"Update payment intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /payment-intents/{paymentIntentId}","href":"/api-reference/payment-intents/update-payment-intent"}]},{"group":"Card Payments","pages":[{"title":"The Card Payment object","href":"/api-reference/card-payments/object"},{"title":"List card payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-payments","href":"/api-reference/card-payments/list-card-payments"},{"title":"Get card payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-payments/{cardPaymentId}","href":"/api-reference/card-payments/get-card-payment"},{"group":"Simulations","pages":[{"title":"Sandbox: Settle a card payment","openapi":"POST /simulations/card-payments/{cardPaymentId}/settle","href":"/api-reference/simulations/settle-card-payment"}]}]},{"group":"Refunds","pages":[{"title":"The Refund object","href":"/api-reference/refunds/object"},{"title":"Create refund","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /refunds","href":"/api-reference/refunds/create-refund"},{"title":"List refunds","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /refunds","href":"/api-reference/refunds/list-refunds"},{"title":"Get refund","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /refunds/{refundId}","href":"/api-reference/refunds/get-refund"}]},{"group":"Chargebacks","pages":[{"title":"The Chargeback object","href":"/api-reference/chargebacks/object"},{"title":"List chargebacks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /chargebacks","href":"/api-reference/chargebacks/list-chargebacks"},{"title":"Get chargeback","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /chargebacks/{chargebackId}","href":"/api-reference/chargebacks/get-chargeback"},{"title":"Submit chargeback evidence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /chargebacks/{chargebackId}/submit","href":"/api-reference/chargebacks/submit-chargeback-evidence"},{"title":"Accept chargeback","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /chargebacks/{chargebackId}/accept","href":"/api-reference/chargebacks/accept-chargeback"}]},{"group":"Chargeback Evidence","pages":[{"title":"The Chargeback Evidence object","href":"/api-reference/chargeback-evidence/object"},{"title":"Get chargeback evidence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /chargebacks/{chargebackId}/evidence","href":"/api-reference/chargebacks/get-chargeback-evidence"},{"title":"Update chargeback evidence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /chargebacks/{chargebackId}/evidence","href":"/api-reference/chargebacks/update-chargeback-evidence"},{"title":"Upload chargeback file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /chargebacks/{chargebackId}/files","href":"/api-reference/chargebacks/upload-chargeback-file"},{"title":"Preview chargeback evidence","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /chargebacks/{chargebackId}/evidence/preview","href":"/api-reference/chargebacks/preview-chargeback-evidence"}]},{"group":"Subscriptions","pages":[{"title":"The Subscription object","href":"/api-reference/subscriptions/object"},{"title":"Create subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /subscriptions","href":"/api-reference/subscriptions/create-subscription"},{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /subscriptions","href":"/api-reference/subscriptions/list-subscriptions"},{"title":"Get subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /subscriptions/{subscriptionId}","href":"/api-reference/subscriptions/get-subscription"},{"title":"Cancel subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /subscriptions/{subscriptionId}/cancel","href":"/api-reference/subscriptions/cancel-subscription"}]},{"group":"Subscription Payments","pages":[{"title":"The Subscription Payment object","href":"/api-reference/subscription-payments/object"},{"title":"List subscription payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /subscriptions/{subscriptionId}/payments","href":"/api-reference/subscriptions/list-subscription-payments"},{"title":"Get subscription payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /subscriptions/{subscriptionId}/payments/{subscriptionPaymentId}","href":"/api-reference/subscriptions/get-subscription-payment"},{"title":"Mark subscription payment paid","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /subscriptions/{subscriptionId}/payments/{subscriptionPaymentId}/mark-paid","href":"/api-reference/subscriptions/mark-subscription-payment-paid"}]},{"group":"Setup intents","pages":[{"title":"The Setup Intent object","href":"/api-reference/setup-intents/object"},{"title":"Create setup intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /setup-intents","href":"/api-reference/setup-intents/create-setup-intent"},{"title":"Get setup intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /setup-intents/{setupIntentId}","href":"/api-reference/setup-intents/get-setup-intent"},{"title":"Cancel setup intent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /setup-intents/{setupIntentId}/cancel","href":"/api-reference/setup-intents/cancel-setup-intent"}]},{"group":"Mandates","pages":[{"title":"The Mandate object","href":"/api-reference/mandates/object"},{"title":"Get mandate","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json get /mandates/{mandateId}","href":"/api-reference/mandates/get-mandate"},{"title":"Revoke mandate","description":"Revoke a card or bank mandate of your party. A card mandate that belongs to a subscription returns `409`, so cancel the subscription instead. Returns the [Mandate object](/api-reference/mandates/object).","deprecated":null,"version":null,"openapi":"/api-reference/openapi-early-access.json post /mandates/{mandateId}/revoke","href":"/api-reference/mandates/revoke-mandate"}]},{"group":"Voice Sessions","pages":[{"title":"The Voice Session object","href":"/api-reference/voice/object"},{"title":"Create voice session","description":"Create a voice session for an open payment intent. Returns the [Voice Session object](/api-reference/voice/object).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /voice/sessions","href":"/api-reference/voice/create-voice-session"},{"title":"List voice sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voice/sessions","href":"/api-reference/voice/list-voice-sessions"},{"title":"Get voice session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voice/sessions/{voiceSessionId}","href":"/api-reference/voice/get-voice-session"},{"group":"Simulations","pages":[{"title":"Sandbox: Simulate a voice call","openapi":"api-reference/openapi-early-access.json POST /simulations/voice-sessions/{voiceSessionId}","href":"/api-reference/simulations/simulate-voice-call"}]}]},{"group":"Voice Session Transcripts","pages":[{"title":"The Voice Session Transcript object","href":"/api-reference/voice-session-transcripts/object"},{"title":"Get voice session transcript","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /voice/sessions/{voiceSessionId}/transcript","href":"/api-reference/voice/get-voice-session-transcript"}]}]},{"group":"Cards","pages":[{"group":"External cards","pages":[{"title":"The External Card object","href":"/api-reference/external-cards/object"},{"title":"List external cards","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /external-cards","href":"/api-reference/external-cards/list-external-cards"},{"title":"Remove external card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /external-cards/{externalCardId}","href":"/api-reference/external-cards/remove-external-card"}]},{"group":"Browser tokens","pages":[{"title":"Overview","href":"/guides/concepts/browser-tokens"},{"title":"Kernel","sidebarTitle":"Use with Kernel","href":"/guides/integrations/kernel"},{"title":"Browser Use","sidebarTitle":"Use with Browser Use","href":"/guides/integrations/browser-use"},{"title":"Encrypted card fields","sidebarTitle":"Encrypted card fields","href":"/guides/integrations/encrypted-card-fields"},{"title":"Create card session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /card-sessions","href":"/api-reference/card-sessions/create-card-session"},{"title":"List card sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-sessions","href":"/api-reference/card-sessions/list-card-sessions"},{"title":"Get card session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-sessions/{sessionId}","href":"/api-reference/card-sessions/get-card-session"},{"title":"Claim card session","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /card-sessions/{sessionId}/claim","href":"/api-reference/card-sessions/claim-card-session"},{"title":"Create merchant report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /merchant-reports","href":"/api-reference/merchant-reports/create-merchant-report"}]},{"group":"Agent tokens","pages":[{"title":"Overview","href":"/guides/concepts/agent-tokens"},{"title":"Get agentic card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic-payments/cards/{cardId}","href":"/api-reference/agent-tokens/get-agentic-card"},{"title":"List agentic mandates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic-payments/mandates","href":"/api-reference/agent-tokens/list-agentic-mandates"},{"title":"Get agentic mandate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic-payments/mandates/{mandateId}","href":"/api-reference/agent-tokens/get-agentic-mandate"},{"title":"Create agentic purchase","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic-payments/purchases","href":"/api-reference/agent-tokens/create-agentic-purchase"},{"title":"Get agentic purchase","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic-payments/purchases/{purchaseId}","href":"/api-reference/agent-tokens/get-agentic-purchase"},{"title":"Claim purchase credential","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic-payments/purchases/{purchaseId}/claim","href":"/api-reference/agent-tokens/claim-purchase-credential"},{"title":"Cancel agentic purchase","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic-payments/purchases/{purchaseId}/cancel","href":"/api-reference/agent-tokens/cancel-agentic-purchase"}]}]},{"group":"Webhooks and events","pages":[{"group":"Webhooks","pages":[{"title":"The Webhook object","href":"/api-reference/webhooks/object"},{"title":"Create webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Rotate webhook signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/{webhookId}/rotate-secret","href":"/api-reference/webhooks/rotate-webhook-signing-secret"},{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Get webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/{webhookId}","href":"/api-reference/webhooks/get-webhook"},{"title":"Update webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /webhooks/{webhookId}","href":"/api-reference/webhooks/update-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /webhooks/{webhookId}","href":"/api-reference/webhooks/delete-webhook"}]},{"group":"Events","pages":[{"title":"The Event object","href":"/api-reference/events/object"},{"title":"Event types","sidebarTitle":"Event catalog","href":"/api-reference/event-catalog"},{"title":"List events","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /events","href":"/api-reference/events/list-events"},{"title":"Get event","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /events/{eventId}","href":"/api-reference/events/get-event"},{"title":"Redeliver event","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/{webhookId}/events/{eventId}/redeliver","href":"/api-reference/events/redeliver-event"}]}]},{"group":"Errors","pages":[{"title":"Error handling","href":"/api-reference/errors/error-handling"},{"group":"Resource errors","boost":0.3,"pages":[{"title":"Agents","href":"/api-reference/errors/agents"},{"title":"Customers","href":"/api-reference/errors/customers"},{"title":"Invitation Links","href":"/api-reference/errors/invitation-links"},{"title":"Payments","href":"/api-reference/errors/payments"},{"title":"Transactions","href":"/api-reference/errors/transactions"},{"title":"Transfers","href":"/api-reference/errors/transfers"},{"title":"Payment Requests","href":"/api-reference/errors/payment-requests"},{"title":"Payment Intents","href":"/api-reference/errors/payment-intents"},{"title":"Card Payments","href":"/api-reference/errors/card-payments"},{"title":"Subscriptions","href":"/api-reference/errors/subscriptions"},{"title":"Setup Intents","href":"/api-reference/errors/setup-intents"},{"title":"Mandates","href":"/api-reference/errors/mandates"},{"title":"Voice Sessions","href":"/api-reference/errors/voice-sessions"},{"title":"Refunds","href":"/api-reference/errors/refunds"},{"title":"Chargebacks","href":"/api-reference/errors/chargebacks"},{"title":"Approvals","href":"/api-reference/errors/approvals"},{"title":"Parties","href":"/api-reference/errors/parties"},{"title":"Party Invitations","href":"/api-reference/errors/party-invitations"},{"title":"Wallets","href":"/api-reference/errors/wallets"},{"title":"External Accounts","href":"/api-reference/errors/external-accounts"},{"title":"External Parties","href":"/api-reference/errors/external-parties"},{"title":"External Party Accounts","href":"/api-reference/errors/external-party-accounts"},{"title":"ACH","href":"/api-reference/errors/ach"},{"title":"Realtime","href":"/api-reference/errors/realtime"},{"title":"Wire","href":"/api-reference/errors/wire"},{"title":"Check","href":"/api-reference/errors/check"},{"title":"API keys","href":"/api-reference/errors/api-keys"},{"title":"Agent keys","href":"/api-reference/errors/agent-keys"},{"title":"Card sessions","href":"/api-reference/errors/card-sessions"},{"title":"Merchant reports","href":"/api-reference/errors/merchant-reports"},{"title":"Webhooks","href":"/api-reference/errors/webhooks"},{"title":"Events","href":"/api-reference/errors/events"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"The Voice Session object - Natural Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}