---
title: "Get project mappings for custom field context"
method: GET
path: "/rest/api/2/field/{fieldId}/context/projectmapping"
tags: ["Issue custom field contexts"]
---

# Get project mappings for custom field context

`GET /rest/api/2/field/{fieldId}/context/projectmapping`

Returns a [paginated](#pagination) list of context to project mappings for a custom field. The result can be filtered by `contextId`. Otherwise, all mappings are returned. Invalid IDs are ignored.

**Note:** Jira is adding support for multiple field contexts per project. On sites where this is enabled, a custom field can have more than one context associated with the same project, so this operation can return several mappings that share the same `projectId`, each with a different `contextId`. Do not assume that a project appears at most once in the response. See [CHANGE-3082](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-3082) for more details.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `fieldId` string, required

## Query parameters

- `contextId` integer[]
- `startAt` integer
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- PageBeanCustomFieldContextProjectMapping — A page of items.
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string, uri — If there is another page of results, the URL of the next page.
  - `self` string, uri — The URL of the page.
  - `startAt` integer — The index of the first item returned.
  - `total` integer — The number of items returned.
  - `values` CustomFieldContextProjectMapping[] — The list of items.
    - `contextId` string, required — The ID of the context.
    - `isGlobalContext` boolean — Whether context is global.
    - `projectId` string — The ID of the project.

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the required permissions.
- `404` — Returned if the custom field is not found.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/revisions/7e9af75061ea/schema)