Skip to main content
    Ivy Biosciences logo
    Ivy Biosciences.bloom* docs
    login.bloom*
    Ivy Biosciences Docs/Call the platform/API/Reference/Reference/Jobs/GET /v1/jobs/{jobId}/artifacts/list-verifications

    GET /v1/jobs/{jobId}/artifacts/list-verifications

    List a job's file verification records

    Open in Claude(opens in a new tab)Open in ChatGPT(opens in a new tab)2 min read
    Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

    Lists the verification records saved for a job you can read, newest first. Records exist only for checks made with persist=true on POST /api/v1/jobs/{job_id}/artifacts/verify.

    All filters are optional and combine. status selects match (hash equals the expected hash), mismatch (it differs), error (the check failed) or unknown (no expected hash was given); any other value is ignored. q matches part of the file key. For the time window, since is used when it is given and hours only when since is empty; an unparseable since or hours is ignored.

    Request

    Path parameters

    jobIdstring (uuid)

    Job UUID.

    Query parameters

    limitinteger

    Maximum number of records to return, from 1 to 200. Defaults to 20.

    statusenum ("match" | "mismatch" | "error" | "unknown")

    Only records with this outcome.

    qstring

    Only records whose file key contains this text, ignoring case.

    sincestring (date-time)

    Only records verified at or after this ISO 8601 timestamp.

    hoursnumber

    Only records verified in the last this many hours. Ignored when since is given.

    Responses

    200 OK

    The matching verification records

    Response shape:

    okenum (true)
    itemsobject[]

    Verification records, newest first

    400 Bad Request

    The job id is empty

    Response shape: object

    401 Unauthorized

    Authentication required

    Response shape: object

    404 Not Found

    The job does not exist, you cannot read it, or it is outside your API key's project scope. All of these return the same body.

    Response shape: object

    429 Too Many Requests

    Rate limit exceeded

    Response shape: object

    500 Internal Server Error

    The records could not be read

    Response shape: object

    curl -X GET 'https://ivybiosciences.com/api/v1/jobs/{jobId}/artifacts/list-verifications' \
  -H "Authorization: Bearer $IVY_API_KEY"

    Was this page helpful?

    GET /v1/jobs/{jobId}/artifacts

    Download a job's output files

    GET /v1/jobs/{jobId}/candidates

    Read a job's study candidates

    Loading...