> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# GetProgramDefinition

# Package: benefitPrograms

# Namespace: ProgramDefinitionService

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/benefit-programs/program-definitions/get-program-definition.md

## Permission Scopes:
SCOPE.BENEFIT_PROGRAMS.READ (PII): SCOPE.BENEFIT_PROGRAMS.READ_LIMITED

## Introduction

Retrieves a program definition.

---

## REST API

### Schema

```
 Method: getProgramDefinition
 Description: Retrieves a program definition.
 URL: https://www.wixapis.com/_api/benefit-programs/v1/program-definitions/{programDefinitionId}
 Method: GET
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  programDefinitionId
 Method parameters: 
   param name: programDefinitionId | type:   none | required: true
 Return type: GetProgramDefinitionResponse
  - name: programDefinition | type: ProgramDefinition | description: Retrieved program definition. 
     - name: id | type: string | description: Program definition GUID. 
     - name: revision | type: string | description: Revision number, which increments by 1 each time the program definition is updated. To prevent conflicting changes, the current revision must be passed when updating the program definition.  Ignored when creating a program definition. 
     - name: createdDate | type: string | description: Date and time the program definition was created. 
     - name: updatedDate | type: string | description: Date and time the program definition was updated. 
     - name: displayName | type: string | description: Program definition name. 
     - name: namespace | type: string | description: Namespace for your app or site's benefit programs. Namespaces allow you to distinguish between entities that you created and entities that other apps created. 
     - name: extendedFields | type: ExtendedFields | description: Custom field data for the program definition object.  [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md) must be configured in the app dashboard before they can be accessed with API calls. 
        - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). 
     - name: externalId | type: string | description: GUID for the program definition defined by you. You can use `externalId` to filter queries. 


```

### Examples

### GetProgramDefinition
```curl
~~~cURL
curl --request GET \
	https://www.wixapis.com/benefit-programs/v1/program-definitions/1f4ef6ff-7228-3c24-9fe2-252f18959285 \
  -H 'Authorization: <AUTH>' \
  -H "Content-Type: application/json"
~~~
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.benefitPrograms.ProgramDefinitionService.getProgramDefinition(programDefinitionId)
 Description: Retrieves a program definition.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  programDefinitionId
 Method parameters: 
   param name: programDefinitionId | type: string | description: GUID of the program definition to retrieve. | required: true
 Return type: PROMISE<ProgramDefinition>
  - name: _id | type: string | description: Program definition GUID. 
  - name: revision | type: string | description: Revision number, which increments by 1 each time the program definition is updated. To prevent conflicting changes, the current revision must be passed when updating the program definition.  Ignored when creating a program definition. 
  - name: _createdDate | type: Date | description: Date and time the program definition was created. 
  - name: _updatedDate | type: Date | description: Date and time the program definition was updated. 
  - name: displayName | type: string | description: Program definition name. 
  - name: namespace | type: string | description: Namespace for your app or site's benefit programs. Namespaces allow you to distinguish between entities that you created and entities that other apps created. 
  - name: extendedFields | type: ExtendedFields | description: Custom field data for the program definition object.  [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions.md) must be configured in the app dashboard before they can be accessed with API calls. 
     - name: namespaces | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md). 
  - name: externalId | type: string | description: GUID for the program definition defined by you. You can use `externalId` to filter queries. 


```

### Examples

### getProgramDefinition
```javascript
import { programDefinitions } from '@wix/benefit-programs';

async function getProgramDefinition(programDefinitionId) {
  const response = await programDefinitions.getProgramDefinition(programDefinitionId);
};
```

### getProgramDefinition (with elevated permissions)
```javascript
import { programDefinitions } from '@wix/benefit-programs';
import { auth } from '@wix/essentials';

async function myGetProgramDefinitionMethod(programDefinitionId) {
  const elevatedGetProgramDefinition = auth.elevate(programDefinitions.getProgramDefinition);
  const response = await elevatedGetProgramDefinition(programDefinitionId);
}
```

### getProgramDefinition (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { programDefinitions } from '@wix/benefit-programs';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { programDefinitions },
  // Include the auth strategy and host as relevant
});


async function getProgramDefinition(programDefinitionId) {
  const response = await myWixClient.programDefinitions.getProgramDefinition(programDefinitionId);
};
```

---