GET /generations/{id}

Poll this endpoint until status is completed or failed.

Use this endpoint to poll an existing generation until it reaches completed or failed. This is where you receive gammaUrl, exportUrl, and credit usage.

Get generation status

get

Retrieves the current status of a generation job. Poll this endpoint until status is "completed" or "failed".

Authorizations

api-key

X-API-KEYstringRequired

API key for authentication

Path parameters

idstringRequired

The unique generation ID returned from the create endpoint

Example: abc123xyz

Responses

200

Generation status retrieved successfully

application/json

generationIdstringRequired

Generation job identifier

Example: abc123xyz

statusstring · enumRequired

Current status of the generation job

Example: completedPossible values:

gammaIdstringOptional

File identifier for the generated Gamma

Example: 9xJZ8QmN2

gammaUrlstringOptional

URL to view the generated Gamma

Example: https://gamma.app/docs/abc123

exportUrlstringOptional

Download URL for exported file (PDF/PPTX)

Example: https://gamma.app/export/abc123.pdf

401

Invalid or missing API key

404

Generation not found

get

/v1.0/generations/{id}

HTTPcURLJavaScriptPython

GET /v1.0/generations/{id} HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "generationId": "abc123xyz",
  "status": "completed",
  "gammaId": "9xJZ8QmN2",
  "gammaUrl": "https://gamma.app/docs/abc123",
  "error": {
    "message": "Failed to generate content",
    "statusCode": 500
  },
  "exportUrl": "https://gamma.app/export/abc123.pdf",
  "credits": {
    "deducted": 10,
    "remaining": 490
  }
}

For usage patterns, see Poll for results.

Related

• Poll for results for complete polling implementations

• POST /generations if you need to start a new generation first