---
title: "Get role"
method: GET
path: "/roles/{ar_code}"
tags: ["Parties"]
---

# Get role

`GET /roles/{ar_code}`

Retrieve a single role using its `ar_code`.

## Path parameters

- `ar_code` string, required

## Query parameters

- `create_parquet` boolean

## Response `200`

Matching role or roles

- Role
  - `ar_code` string — VegBank role identifier
  - `name` string — Role name/label
  - `description` string — Role description

## Other responses

- `400` — Invalid Parameters

## Changes

> 50 revisions in range; 1 not diffed, 13 could not be searched.

- **2026-01-26** `bb3e0780afdd` — 1 info
  - endpoint added
- **2025-04-29** `c9e23cb778c9` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nceas/apis/vegbankapi/changes/roles/:ar_code/get.md)

---

[API](https://skmtc.dev/nceas/apis/vegbankapi.md) · [All operations](https://skmtc.dev/nceas/apis/vegbankapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nceas/vegbankapi/revisions/852fd165e202/schema)