---
title: "Get a list of entries from a Scabbard service's state"
method: GET
path: "/scabbard/{circuit}/{service_id}/state"
tags: ["Scabbard"]
---

# Get a list of entries from a Scabbard service's state

`GET /scabbard/{circuit}/{service_id}/state`

This endpoint can be used to fetch a list of entries from a Scabbard
service's state. The entries can be filtered using an address prefix
provided with the `prefix` query parameter.

This endpoint requires the permission "scabbard.read".

## Path parameters

- `circuit` string, required
- `service_id` string, required

## Query parameters

- `prefix` string

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `200`

The state entries were successfully retrieved

- object[]
  - `address` string
  - `value` integer[]

## Other responses

- `400` — The request was malformed
- `401` — The client is unauthorized
- `404` — The scabbard service with the given circuit and service id was not found
- `500` — An internal server error occurred

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)