---
title: "Poll a demonstration rank check"
method: GET
path: "/api/sandbox/rankchecks/{jobId}"
tags: ["Sandbox"]
---

# Poll a demonstration rank check

`GET /api/sandbox/rankchecks/{jobId}`

## Request

- Base URL: `https://api.appskyline.com`
- URL: `https://api.appskyline.com/api/sandbox/rankchecks/{jobId}`
- Auth: none required

Reads the status of a demonstration job started at `POST /api/sandbox/rankchecks`. While the job runs the status is `running`; afterwards it is `succeeded` and the body carries the checked term's rank in every store carrying it. No authentication is required.

## Path parameters

- `jobId` string, required

## Response `200`

Current job state.

- object
  - `_id` string
  - `status` 'pending' | 'running' | 'succeeded'
  - `creationTime` string, date-time
  - `completionTime` string, date-time
  - `ranks` object[]
    - `searchTerms` string
    - `store` string
    - `country` string
    - `rank` integer

## Other responses

- `404`: Unknown job id.

---

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