Sign in

v6

latestOpenAPI 3.1.02026-07-311856741.1 MB
benefits
public

List Benefits

List benefits.

Scopes: benefits:read benefits:write

get/v1/benefits/

Query parameters

string uuid4

The organization ID.

OR
string[]
Example:1dbfc517-0bbf-4301-9ba8-555ca42b9737

Filter by organization ID.

'custom' | 'discord' | 'github_repository' | 'downloadables' | 'license_keys' | 'meter_credit' | 'feature_flag' | 'slack_shared_channel'
OR
BenefitType[]

Filter by benefit type.

string uuid4

The benefit ID.

OR
string[]

Filter by benefit IDs.

string uuid4

The benefit ID.

OR
string[]

Exclude benefits with these IDs.

querystring nullable

Filter by description.

Filter by description.

pageinteger

Page number, defaults to 1.

Page number, defaults to 1.

limitinteger

Size of a page, defaults to 10. Maximum is 100.

Size of a page, defaults to 10. Maximum is 100.

sortingBenefitSortProperty[] nullable

Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign - before the criteria name to sort by descending order.

Sorting criterion. Several criteria can be used simultaneously and will be applied in order. Add a minus sign - before the criteria name to sort by descending order.

metadataobject nullable

Filter by metadata key-value pairs. It uses the deepObject style, e.g. ?metadata[key]=value.

Response

Successful Response

Example response

{
  "items": [
    {
      "properties": {
        "repository_owner": "polarsource",
        "repository_name": "private_repo"
      }
    }
  ]
}