---
title: "Get onboarding job status"
method: GET
path: "/onboarding/v2/jobs/{id}"
---

# Get onboarding job status

`GET /onboarding/v2/jobs/{id}`

Used for polling purposes, to collect the job status of an ongoing company or individual creation request. Returns the location of the resource or a list of errors, depending on the outcome of the operation.

## Path parameters

- `id` string, required

## Response `200`

Ok - job status retrieved successfully.

- ApiResponseWrapperOnboardingAsyncJob
  - `data` OnboardingAsyncJob
    - `id` string — The unique identifier for the created resource.
    - `location` string — Location (URL) of the created resource.
  - `errors` ErrorResponse[] — List of errors for the job. Returns `null` if it is successful.
    - `code` string — Code describing the error.
    - `doc_link` string — The link for the error documentation. Follow it to gather more details about the error
    - `field` string — A validation error can specify the field that generated that error.
    - `message` string — Detailed message containing information on how to resolve the error.
    - `type` string — Type of error: validation, tax_authority, warning, general, unknown.
  - `message` string — Message describing the status of the operation.
  - `status` string — The status of the asynchronous job. Returns success when the operation has completed.

## Other responses

- `400` — Bad customer request - the required field 'id' was not provided.
- `401` — Authentication failed - missing or incorrect subscription key.
- `429` — Too many requests were sent for a short period of time. Try again a bit later.
- `5XX` — Internal server error. Its not you, its us! We are experiencing a rare and unexpected system disruption. Retry again later. The message field of the response will contain more information for the cause. Feel free to contact us.

---

[API](https://skmtc.net/fonoa/apis/fonoa-api.md) · [All operations](https://skmtc.net/fonoa/apis/fonoa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fonoa/fonoa-api/versions/cf0ebc843a3f/schema)