PostliftDevelopers
Documentation menu
Your own Voice

Poll voice analysis and charges

Use this endpoint from your own integration, with the same account permissions and safeguards as the app.

Scope · voice:read

Request

GET/api/v1/voice/{accountId}/jobs/{jobId}
Example requestcURL
curl 'https://postlift.io/api/v1/voice/{accountId}/jobs/{jobId}' \
  -H "Authorization: Bearer $POSTLIFT_API_KEY"

Replace path placeholders with your Postlift resource IDs. Example timestamps must be replaced with a future time; preserve the same timestamp when retrying the same operation.

Parameters

NameLocationDescription
accountIdrequiredpathPostlift resource ID belonging to the API key owner.
jobIdrequiredpathPostlift resource ID belonging to the API key owner.

Response

200 Successful operation.

FieldType & constraints
jobrequiredVoiceJob ↗
aiRequestsoptionalobject[]
Explore VoiceJobEnvelope ↗
View JSON schema
{
  "type": "object",
  "properties": {
    "job": {
      "$ref": "#/components/schemas/VoiceJob"
    },
    "aiRequests": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "required": [
    "job"
  ],
  "additionalProperties": true
}

Errors & retries

Failures use a stable error code and request ID. Check the current resource version or request status before retrying a write.

StatusMeaning
400Invalid input or Jev rejection
401Invalid, expired or revoked API key
402Plan, publishing quota or AI credit requirement
403Missing scope
404Resource not found or not owned
409Version conflict, missing voice or duplicate AI operation
413Payload too large
429Rate or concurrency limit
500Internal error
502Upstream failure; inspect operation status
503Service or review unavailable
Read the retry guide ↗