---
title: "Retrieve valid Task Name prefixes for the authenticated firm"
method: GET
path: "/fhir/v2/ValueSet/task-name"
tags: ["Tasks/Recalls"]
---

# Retrieve valid Task Name prefixes for the authenticated firm

`GET /fhir/v2/ValueSet/task-name`

## Request

- Base URL: `https://stage.ema-api.com/ema-dev/firm/apiportal/ema`
- URL: `https://stage.ema-api.com/ema-dev/firm/apiportal/ema/fhir/v2/ValueSet/task-name`
- Auth: HTTP bearer and API key in header `x-api-key`

Returns the ValueSet of Task Name values configured for the authenticated firm. The `code` of each concept is the valid prefix to use before the colon in Task.description when creating or updating a Task (e.g. `BASIC: Follow up with patient`). Available values are firm-specific — call this endpoint to discover the current set rather than relying on a fixed list.

## Response `200`

Success

- FHIRJSONRESOURCE: A FHIR resource

## Other responses

- `400`: BAD REQUEST - The request was bad, often due to a missing required parameter
- `401`: NOT AUTHORIZED - Authentication error; this token is not allowed access to the API
- `403`: FORBIDDEN
- `404`: NOT FOUND
- `422`: UNPROCESSABLE ENTITY - Request could not be processed; typically a validation error
- `429`: TOO MANY REQUESTS - Request was rate limited (1000 calls/min default); please retry
- `500`: SERVER ERROR - Internal Server Error

---

[API](https://skmtc.dev/modmed/apis/ema-proprietary-api.md) - [All operations](https://skmtc.dev/modmed/apis/ema-proprietary-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modmed/apis/ema-proprietary-api/revisions/c03c1956a05d?raw)