---
title: "Get Integration Resource"
method: GET
path: "/v1/installations/{integrationConfigurationId}/resources/{resourceId}"
tags: ["marketplace"]
---

# Get Integration Resource

`GET /v1/installations/{integrationConfigurationId}/resources/{resourceId}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/installations/{integrationConfigurationId}/resources/{resourceId}`
- Auth: HTTP bearer

Get a resource by its partner ID.

## Path parameters

- `integrationConfigurationId` string, required: The ID of the integration configuration (installation) the resource belongs to
- `resourceId` string, required: The ID provided by the 3rd party provider for the given resource

## Response `200`

- object
  - `billingPlanId` string: The ID of the billing plan the resource is subscribed to, if applicable
  - `customClaims` object: The roles and claim rules Vercel resolves into the resource tokens it mints for this resource
    - `claimRules` object[]
      - `claims` object, required
      - `when` object
        - `environment` string[]
        - `role` string[]
    - `defaultRole` string
    - `roles` string[]
  - `id` string, required: The ID provided by the 3rd party provider for the given resource
  - `internalId` string, required: The ID assigned by Vercel for the given resource
  - `metadata` object: The configured metadata for the resource as defined by its product's Metadata Schema
  - `name` string, required: The name of the resource as it is recorded in Vercel
  - `notification` object: The notification, if set, displayed to the user when viewing the resource in Vercel
    - `href` string
    - `level` 'error' | 'info' | 'warn', required
    - `message` string
    - `title` string, required
  - `productId` string, required: The ID of the product the resource is derived from
  - `protocolSettings` object: Any settings provided for the resource to support its product's protocols
    - `authentication` object
      - `appUrls` object[]
        - `target` 'development' | 'preview' | 'production', required
        - `url` string, required
    - `experimentation` object
      - `edgeConfigId` string
      - `globalConfigId` string
  - `status` 'error' | 'onboarding' | 'pending' | 'ready' | 'resumed' | 'suspended' | 'uninstalled': The current status of the resource

## Other responses

- `400`: One of the provided values in the request query is invalid.
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`

## Changes

- **2026-10-15** `8939e3983223`: 1 breaking
  - response property `customClaims/claimRules/items/claims/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
- **2026-09-24** `dd6a90982ed0`: 1 info
  - added the optional property `customClaims` to the response with the `200` status
- **2026-08-17** `4c652701e115`: 1 info
  - added the optional property `protocolSettings/authentication` to the response with the `200` status
- **2026-07-26** `01c71864fa50`: 2 warning, 1 info
  - removed the optional property `protocolSettings/experimentation/edgeConfigSyncingEnabled` from the response with the `200` status
  - removed the optional property `protocolSettings/experimentation/edgeConfigTokenId` from the response with the `200` status
  - added the optional property `protocolSettings/experimentation/globalConfigId` to the response with the `200` status
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/installations/:integrationConfigurationId/resources/:resourceId/get.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)