---
title: "Retrieves a single agency plugin for a specific user."
method: GET
path: "/agency/{agency_id}/user/{user_id}/plugin/{plugin_id}"
tags: ["User Plugins"]
---

# Retrieves a single agency plugin for a specific user.

`GET /agency/{agency_id}/user/{user_id}/plugin/{plugin_id}`

## Response `200`

A plugin object for display

- PluginDisplay
  - `sPluginSettingId` string, required — The id of the setting that will be used for this plugin
  - `objPluginAsset` ObjPluginAsset, required
    - `objOwner` ObjOwner, required
      - `sOwnerId` string, required — The id of the resource that creates the plugin setting
      - `sOwnerType` string, required — The name of the resource that creates the plugin setting
    - `sResourceId` string, required — The id of the resource thatthe plugin will be created for
  - `dtModified` string, date-time, required — Date the document was last updated
  - `dtCreated` string, date-time, required — Date the document was created
  - `objSetting` ObjSetting, required
    - `sPluginName` string, required — The name of the plugin for which the setting is being created
    - `sMenuIcon` string, required — The icon that will be displayed for the plugin menu item
    - `sMenuIconSelected` string, required — The icon that will be displayed for the plugin menu item when it is selected
    - `sMenuLabel` string, required — The label for them plugin menu item
    - `sOverviewUrl` string, required — The url pointing to the Overview resource of the plugin
    - `sFormUrl` string, required — The url pointing to the Form resource of the plugin
  - `sPluginType` string, required — The type of plugin
  - `sResourceType` string, required — The type of resource for which the plugin was created

## Other responses

- `400` — Validation Error. Usually caused by a missing or invalid parameter.
- `401` — Authorization Error. Thrown if the user does not have access to resource.
- `404` — No such record
- `default` — unexpected error

---

[API](https://skmtc.dev/staffshift/apis/staffshift-api-gateway.md) · [All operations](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/staffshift/staffshift-api-gateway/revisions/6e2cb83db3a9/schema)