Skip to content
SegmentationAPI

Retrieve a completed segmentation job result

GET
/v1/jobs/{jobId}/result
curl --request GET \
  --url https://api.segmentationapi.com/v1/jobs/example/result \
  --header 'Authorization: Bearer <token>'

Returns the result manifest with short-lived signed URLs for owned output assets.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
jobId
required
string

Async job identifier.

Responses

Section titled “Responses”

200

Section titled “200”

Completed result manifest and signed assets

Media typeapplication/json
object
manifest
required
One of: discriminator: type
object
jobId
required
string
type
required
string
Allowed values: image
prompts
required
Array<string>
items
required
Array<object>
object
taskId
required
string
inputId
required
string
units
required
integer
generatedAt
required
string format: date-time
previewUrl
string format: uri
masks
required
Array<object>
object
maskIndex
required
integer
confidence
required
number
url
required
string format: uri
assets
required
Array<object>
object
key
required

Job-relative output asset key.

string
url
required
string format: uri
expiresIn
required
integer
>= 60
Example
{
  "manifest": {
    "type": "image"
  }
}

401

Section titled “401”

Authentication is missing, invalid, or expired

Media typeapplication/json
object
error
required
string
message
string
remainingTokens
integer
requestedTokens
integer
>= 1
expiresAt
string format: date-time
activeJobId
string
upgradeUrl
string format: uri
retryAfterSeconds
integer
>= 1
Examplegenerated
{
  "error": "example",
  "message": "example",
  "remainingTokens": 1,
  "requestedTokens": 1,
  "expiresAt": "2026-04-15T12:00:00Z",
  "activeJobId": "example",
  "upgradeUrl": "https://example.com",
  "retryAfterSeconds": 1
}

404

Section titled “404”

The requested resource was not found

Media typeapplication/json
object
error
required
string
message
string
remainingTokens
integer
requestedTokens
integer
>= 1
expiresAt
string format: date-time
activeJobId
string
upgradeUrl
string format: uri
retryAfterSeconds
integer
>= 1
Examplegenerated
{
  "error": "example",
  "message": "example",
  "remainingTokens": 1,
  "requestedTokens": 1,
  "expiresAt": "2026-04-15T12:00:00Z",
  "activeJobId": "example",
  "upgradeUrl": "https://example.com",
  "retryAfterSeconds": 1
}

409

Section titled “409”

Request conflicts with the current resource state

Media typeapplication/json
object
error
required
string
message
string
remainingTokens
integer
requestedTokens
integer
>= 1
expiresAt
string format: date-time
activeJobId
string
upgradeUrl
string format: uri
retryAfterSeconds
integer
>= 1
Examplegenerated
{
  "error": "example",
  "message": "example",
  "remainingTokens": 1,
  "requestedTokens": 1,
  "expiresAt": "2026-04-15T12:00:00Z",
  "activeJobId": "example",
  "upgradeUrl": "https://example.com",
  "retryAfterSeconds": 1
}

500

Section titled “500”

Internal server error

Media typeapplication/json
object
error
required
string
message
string
remainingTokens
integer
requestedTokens
integer
>= 1
expiresAt
string format: date-time
activeJobId
string
upgradeUrl
string format: uri
retryAfterSeconds
integer
>= 1
Examplegenerated
{
  "error": "example",
  "message": "example",
  "remainingTokens": 1,
  "requestedTokens": 1,
  "expiresAt": "2026-04-15T12:00:00Z",
  "activeJobId": "example",
  "upgradeUrl": "https://example.com",
  "retryAfterSeconds": 1
}