---
title: "Where the upload stands"
method: GET
path: "/sort-sessions/{sortSessionId}"
tags: ["Uploads"]
---

# Where the upload stands

`GET /sort-sessions/{sortSessionId}`

## Request

- Base URL: `https://api.tarifflo.com/api/v2`
- URL: `https://api.tarifflo.com/api/v2/sort-sessions/{sortSessionId}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Requires the API key scope `filing`.

## Path parameters

- `sortSessionId` string, required

## Response `200`

Successful response

- object
  - `id` string, required
  - `name` string, required
  - `configurationId` string, required
  - `lane` 'entry' | 'classification', required
  - `runs` object[], required
    - `scope` 'upload' | 'entry', required
    - `refId` string, required
    - `runId` string, required
    - `status` 'running' | 'blocked' | 'complete' | 'failed' | 'cancelled', required
    - `stages` object[], required
      - `key` string, required
      - `status` 'pending' | 'running' | 'finalizing' | 'complete_with_open' | 'awaiting_gate' | 'held' | 'complete' | 'failed' | 'blocked' | 'skipped', required
      - `total` number, required
      - `completed` number, required
      - `failed` number, required
      - `parked` number, required
      - `awaitingInput` number, required
      - `creditsNeeded` number, nullable, required
  - `counts` object, nullable, required
    - `products` number, required
    - `classified` number, required
    - `withOrigin` number, required
    - `priced` number, required
    - `compared` number, required
    - `unpriceable` number, required
    - `pendingApproval` number, required
  - `report` union, required
    - object
      - `state` 'ready', required
      - `runId` string, required
      - `reportId` string, required
      - `fileName` string, required
      - `url` string, required
      - `expiresInMinutes` number, required
    - object
      - `state` 'building', required
      - `runId` string, required
    - object
      - `state` 'unavailable', required
      - `reason` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/tarifflo/apis/tarifflo-api.md) - [All operations](https://skmtc.dev/tarifflo/apis/tarifflo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tarifflo/apis/tarifflo-api/revisions/f048ebac1ac5?raw)