---
title: "Query information about an artifact"
method: POST
path: "/v8/artifacts"
tags: ["artifacts"]
---

# Query information about an artifact

`POST /v8/artifacts`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v8/artifacts`
- Auth: HTTP bearer

Query information about an array of artifacts.

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `hashes` string[], required: artifact hashes

## Response `200`

- object

## Other responses

- `400`: One of the provided values in the request body is invalid.
- `401`: The request is not authorized.
- `402`: The account is missing a payment so payment method must be updated
- `403`: The customer has reached their spend cap limit and has been paused. An owner can disable the cap or raise the limit in settings. The Remote Caching usage limit has been reached for this account for this billing cycle. Remote Caching has been disabled for this team or user. An owner can enable it in the billing settings. You do not have permission to access this resource.
- `404`
- `410`

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2026-06-11** `14b4658f819e`: 2 info
  - added the optional property `additionalProperties/oneOf[subschema #1]/dirtyHash` to the response with the `200` status
  - added the optional property `additionalProperties/oneOf[subschema #1]/sha` to the response with the `200` status
- **2026-01-22** `c12186034433`: 1 breaking
  - request body became required
- **2025-03-19** `37b482c58c92`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v8/artifacts/post.md)

---

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