> ## Documentation Index > Fetch the complete documentation index at: https://docs.brightalk.ai/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a call summary > Returns the independently revisioned summary result for one API-visible call. Processing, unavailable, and exhausted processing are normal HTTP 200 result states. Every response includes Brightalk-Version and X-Request-Id; rate-limited responses also expose the effective bucket counters. ## OpenAPI ````yaml /openapi/openapi.yaml get /calls/{call_id}/summary openapi: 3.1.0 info: title: Brightalk Public API version: '2026-07-16' description: >- Server-to-server REST API for AI calls, batch dialing, and dashboard-managed Automation definitions. license: name: Brightalk API Terms identifier: LicenseRef-Brightalk-API servers: - url: https://api.brightalk.ai description: Production security: - bearerAuth: [] tags: - name: Agents description: Eligible dashboard-managed AI voice agents. - name: Automations description: Dashboard-managed Automation summaries. - name: Contacts description: Organization contacts and external identities. - name: Calls description: Immediate asynchronous AI calls and their scalar results. - name: Batches description: Draft, schedule, and control aggregate batch dialing. - name: Automation runs description: Create and control one-contact Automation runs. paths: /calls/{call_id}/summary: get: tags: - Calls summary: Retrieve a call summary description: >- Returns the independently revisioned summary result for one API-visible call. Processing, unavailable, and exhausted processing are normal HTTP 200 result states. Every response includes Brightalk-Version and X-Request-Id; rate-limited responses also expose the effective bucket counters. operationId: getCallSummary parameters: - $ref: '#/components/parameters/BrightalkVersion' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/CallIdPath' responses: '200': description: Current summary result returned, including normal processing states. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/CallSummary' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '405': $ref: '#/components/responses/MethodNotAllowed' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' x-codeSamples: - lang: curl label: cURL source: >- curl --request GET 'https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/summary' \ --header "Authorization: Bearer $BRIGHTALK_API_KEY" \ --header "Brightalk-Version: 2026-07-16" - lang: javascript label: JavaScript source: >- const response = await fetch("https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/summary", { method: "GET", headers: { Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`, "Brightalk-Version": "2026-07-16", }, }); console.log(response.status, await response.json()); - lang: python label: Python source: |- import os import requests response = requests.request( "GET", "https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/summary", headers={ "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}", "Brightalk-Version": "2026-07-16", }, ) print(response.status_code, response.json()) components: parameters: BrightalkVersion: name: Brightalk-Version in: header required: false description: >- Selects the date-based API version. Omission uses the organization’s pinned default. schema: type: string const: '2026-07-16' default: '2026-07-16' XRequestId: name: X-Request-Id in: header required: false description: >- A caller-generated correlation value matching [A-Za-z0-9._:-]{1,64}. Invalid values are replaced. schema: type: string pattern: ^[A-Za-z0-9._:-]{1,64}$ maxLength: 64 CallIdPath: name: call_id in: path required: true description: The opaque Call identifier. schema: type: string format: uuid minLength: 1 maxLength: 255 description: An opaque resource identifier. example: 11111111-1111-4111-8111-111111111111 headers: Brightalk-Version: description: The date-based version applied to the request. required: true schema: type: string const: '2026-07-16' X-Request-Id: description: The accepted caller correlation value or a server-generated replacement. required: true schema: type: string pattern: ^[A-Za-z0-9._:-]{1,64}$ RateLimit-Limit: description: The effective request allowance for the selected bucket. schema: type: integer minimum: 1 RateLimit-Remaining: description: The nonnegative number of requests remaining in the selected bucket. schema: type: integer minimum: 0 RateLimit-Reset: description: >- A nonnegative integer number of delta-seconds from response generation until the effective bucket resets; never an epoch timestamp. schema: type: integer minimum: 0 Allow: description: A comma-separated list of methods allowed on the known path. schema: type: string example: GET, POST Retry-After: description: >- A nonnegative integer number of delta-seconds to wait before retrying; never an epoch timestamp. schema: type: integer minimum: 0 schemas: CallSummary: description: >- Independently revisioned call summary result. A higher revision means the sanitized endpoint content changed; an identical reprojection keeps the current revision. oneOf: - type: object additionalProperties: false description: Processing normally; poll again after the documented interval. required: - object - schema_version - call_id - status - revision - summary - reason - generated_at - poll_after_seconds properties: object: type: string const: call_summary schema_version: type: string const: '2026-07-28' call_id: type: string format: uuid minLength: 1 maxLength: 255 status: type: string const: processing revision: type: integer const: 0 summary: type: 'null' reason: type: 'null' generated_at: type: 'null' poll_after_seconds: type: integer const: 5 - type: object additionalProperties: false description: Summary content is ready for this revision. required: - object - schema_version - call_id - status - revision - summary - reason - generated_at - poll_after_seconds properties: object: type: string const: call_summary schema_version: type: string const: '2026-07-28' call_id: type: string format: uuid minLength: 1 maxLength: 255 status: type: string const: ready revision: type: integer minimum: 1 summary: type: string minLength: 1 maxLength: 4000 reason: type: 'null' generated_at: type: string format: date-time poll_after_seconds: type: 'null' - type: object additionalProperties: false description: The call cannot produce a summary; inspect the stable reason. required: - object - schema_version - call_id - status - revision - summary - reason - generated_at - poll_after_seconds properties: object: type: string const: call_summary schema_version: type: string const: '2026-07-28' call_id: type: string format: uuid minLength: 1 maxLength: 255 status: type: string const: unavailable revision: type: integer minimum: 1 summary: type: 'null' reason: $ref: '#/components/schemas/CallResultUnavailableReason' generated_at: type: 'null' poll_after_seconds: type: 'null' - type: object additionalProperties: false description: Safe summary processing was exhausted. required: - object - schema_version - call_id - status - revision - summary - reason - generated_at - poll_after_seconds properties: object: type: string const: call_summary schema_version: type: string const: '2026-07-28' call_id: type: string format: uuid minLength: 1 maxLength: 255 status: type: string const: failed revision: type: integer minimum: 1 summary: type: 'null' reason: type: string const: processing_failed generated_at: type: 'null' poll_after_seconds: type: 'null' CallResultUnavailableReason: type: string description: >- Stable reason a result is unavailable. call_not_connected means the call never connected; no_usable_audio means no safe audio source exists; no_speech means no usable conversation was detected; not_retained means the content is no longer retained. enum: - call_not_connected - no_usable_audio - no_speech - not_retained ErrorEnvelope: type: object additionalProperties: false properties: error: $ref: '#/components/schemas/Error' required: - error Error: type: object additionalProperties: false properties: code: type: string enum: - authentication_required - invalid_api_key - api_key_expired - organization_not_enabled - insufficient_scope - unsupported_version - validation_error - invalid_json - resource_not_found - resource_state_conflict - method_not_allowed - request_too_large - unsupported_destination - contact_identity_conflict - idempotency_key_required - idempotency_conflict - idempotency_in_progress - duplicate_active_run - rate_limit_exceeded - recipient_blocked_by_policy - internal_error example: validation_error message: type: string example: The request could not be validated. request_id: type: string pattern: ^[A-Za-z0-9._:-]{1,64}$ example: req_demo_001 details: $ref: '#/components/schemas/ErrorDetails' required: - code - message - request_id ErrorDetails: type: object additionalProperties: false properties: fields: type: array maxItems: 50 items: $ref: '#/components/schemas/ErrorField' truncated: type: boolean const: true supported_versions: type: array items: type: string pattern: ^\d{4}-\d{2}-\d{2}$ existing_run_id: type: string minLength: 1 maxLength: 255 description: An opaque resource identifier. example: run_demo_001 ErrorField: type: object additionalProperties: false properties: path: type: string example: recipient.phone_number code: type: string example: invalid_e164 required: - path - code responses: BadRequest: description: >- The version, request, query, or state-independent destination validation failed. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: validationError: value: error: code: validation_error message: The request could not be validated. request_id: req_demo_001 details: fields: - path: recipient.phone_number code: invalid_e164 unsupportedVersion: value: error: code: unsupported_version message: The requested API version is not supported. request_id: req_demo_001 details: supported_versions: - '2026-07-16' unsupportedDestination: value: error: code: unsupported_destination message: The destination is not supported. request_id: req_demo_001 Unauthorized: description: Authentication failed. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: missingBearer: value: error: code: authentication_required message: Authentication is required. request_id: req_demo_001 malformedBearer: value: error: code: authentication_required message: Authentication is required. request_id: req_demo_001 unknownOrRevokedCredential: value: error: code: invalid_api_key message: The API key is invalid. request_id: req_demo_001 expiredCredential: value: error: code: api_key_expired message: The API key has expired. request_id: req_demo_001 Forbidden: description: The request is not authorized for this API operation. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: organizationNotEnabled: value: error: code: organization_not_enabled message: The organization is not enabled for the Public API. request_id: req_demo_001 insufficientScope: value: error: code: insufficient_scope message: The API key does not have the required scope. request_id: req_demo_001 NotFound: description: The resource is absent or not visible to this organization. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: resourceNotFound: value: error: code: resource_not_found message: The requested resource was not found. request_id: req_demo_001 MethodNotAllowed: description: The path is known but the method is not allowed. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' Allow: $ref: '#/components/headers/Allow' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: methodNotAllowed: value: error: code: method_not_allowed message: The method is not allowed for this resource. request_id: req_demo_001 TooManyRequests: description: The selected request bucket is exhausted. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: rateLimitExceeded: value: error: code: rate_limit_exceeded message: The rate limit has been exceeded. request_id: req_demo_001 InternalError: description: The request could not be completed safely. headers: Brightalk-Version: $ref: '#/components/headers/Brightalk-Version' X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' examples: internalError: value: error: code: internal_error message: An unexpected error occurred. request_id: req_demo_001 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Brightalk API key description: Use a server-side Brightalk API key in the Authorization header. ````