---
title: "GET /transform/v1/jobs/key/{key}"
method: GET
path: "/transform/v1/jobs/key/{key}"
---

# GET /transform/v1/jobs/key/{key}

`GET /transform/v1/jobs/key/{key}`

Fetch an existing job by a recent key.

## Path parameters

- `key` string, required — Key of the job to fetch.

## Response `200`

OK

- TransformJob
  - `args` object — Any additional arguments that might be used by workflow actions.
  - `attachments` TransformFile[] — Any files that have been generated while processing the job in the workflow will be here.
    - `category` string — Category of the file
    - `desc` string — Description of the file
    - `hash` string — SHA256 hash of the file
    - `id` string — UUID for the file inside the entry
    - `key` string — Short identifier for the file.
    - `meta` object — Any additional data that might be relevant.
    - `mime` string — MIME type of the file
    - `name` string — Name of the file
    - `size` integer — Size of the file in bytes
    - `url` string — Public URL where the file can be downloaded.
  - `completed_at` string — When this job was completed, will be nil if still ongoing.
  - `created_at` string — When the job was created.
  - `envelope` object — Raw JSON data of the complete GOBL Envelope.
  - `faults` TransformFault[] — Array of fault objects that represent errors that occurred during the processing of the job.
    - `code` string — Code assigned by the provider that may provide additional information about the fault.
    - `message` string — Message assigned by the provider that may provide additional information about the fault.
    - `provider` string — ID of the provider that generated the fault.
  - `id` string — The UUID v7 or v1 of the job
  - `intents` TransformIntent[] — Array of intent objects following the execution of each of the steps of the associated workflow.
    - `completed` boolean — When true, this intent has completed.
    - `created_at` string — When the intent was created.
    - `events` TransformEvent[] — Array of event objects tracking the execution of the intent.
      - `args` object — Map of additional arguments that will be included in embedded actions.
      - `at` string — When the event was created.
      - `code` string — Code assigned by the provider that may provide additional information about the event.
      - `index` integer — Index of the event in the intent.
      - `message` string — Message assigned by the provider that may provide additional information about the event, especially errors.
      - `silo_entry_id` string — ID of the entry in the silo that was created by this event.
      - `status` string — Status of the event.
    - `id` string — UUIDv4 for the Intent
    - `name` string — Name of the executed workflow step
    - `provider` string — ID of the provider to use
    - `step_id` string — ID of the step to use
    - `updated_at` string — When the intent was last updated.
  - `key` string — Key assigned to the job, used to identify it in the system.
  - `silo_entry_id` string
  - `status` string — Last known status text for this job.
  - `tags` string[] — Any tags that may be useful to be associated with the job.
  - `updated_at` string — When the job was last updated.
  - `workflow_id` string

---

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