List Benefit Grants

GET

benefits

{id}

grants

package main

import(
	"context"
	"os"
	polargo "github.com/polarsource/polar-go"
	"github.com/polarsource/polar-go/models/operations"
	"log"
)

func main() {
    ctx := context.Background()
    
    s := polargo.New(
        polargo.WithSecurity(os.Getenv("POLAR_ACCESS_TOKEN")),
    )

    res, err := s.Benefits.Grants(ctx, operations.BenefitsGrantsRequest{
        ID: "<value>",
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.ListResourceBenefitGrant != nil {
        for {
            // handle items

            res, err = res.Next()

            if err != nil {
                // handle error
            }

            if res == nil {
                break
            }
        }
    }
}

{
  "items": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "modified_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "granted_at": "2023-11-07T05:31:56Z",
      "is_granted": true,
      "revoked_at": "2023-11-07T05:31:56Z",
      "is_revoked": true,
      "subscription_id": "<string>",
      "order_id": "<string>",
      "customer_id": "<string>",
      "user_id": "<string>",
      "benefit_id": "<string>",
      "customer": {
        "created_at": "2023-11-07T05:31:56Z",
        "modified_at": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "metadata": {},
        "email": "<string>",
        "email_verified": true,
        "name": "<string>",
        "billing_address": {
          "line1": "<string>",
          "line2": "<string>",
          "postal_code": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>"
        },
        "tax_id": [
          "<any>"
        ],
        "organization_id": "<string>",
        "avatar_url": "<string>"
      },
      "properties": {
        "account_id": "<string>",
        "guild_id": "<string>",
        "role_id": "<string>"
      }
    }
  ],
  "pagination": {
    "total_count": 123,
    "max_page": 123
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

The benefit ID.

Query Parameters

is_granted

boolean | null

Filter by granted status. If true, only granted benefits will be returned. If false, only revoked benefits will be returned.

customer_id

Filter by customer.

page

integer

default:

Page number, defaults to 1.

Required range: x > 0

limit

integer

default:

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

Required range: x > 0

Response

200

application/json

Successful Response

items

object[]

required

items.created_at

string

required

Creation timestamp of the object.

items.modified_at

string | null

required

Last modification timestamp of the object.

items.id

string

required

The ID of the grant.

items.is_granted

boolean

required

Whether the benefit is granted.

items.is_revoked

boolean

required

Whether the benefit is revoked.

items.subscription_id

string | null

required

The ID of the subscription that granted this benefit.

items.order_id

string | null

required

The ID of the order that granted this benefit.

items.customer_id

string

required

The ID of the customer concerned by this grant.

items.user_id

string

requireddeprecated

items.benefit_id

string

required

The ID of the benefit concerned by this grant.

items.customer

object

required

A customer in an organization.

items.properties

object

required

items.granted_at

string | null

The timestamp when the benefit was granted. If None, the benefit is not granted.

items.revoked_at

string | null

The timestamp when the benefit was revoked. If None, the benefit is not revoked.

pagination

object

required

Was this page helpful?

List Benefits

Update Benefit

package main

import(
	"context"
	"os"
	polargo "github.com/polarsource/polar-go"
	"github.com/polarsource/polar-go/models/operations"
	"log"
)

func main() {
    ctx := context.Background()
    
    s := polargo.New(
        polargo.WithSecurity(os.Getenv("POLAR_ACCESS_TOKEN")),
    )

    res, err := s.Benefits.Grants(ctx, operations.BenefitsGrantsRequest{
        ID: "<value>",
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.ListResourceBenefitGrant != nil {
        for {
            // handle items

            res, err = res.Next()

            if err != nil {
                // handle error
            }

            if res == nil {
                break
            }
        }
    }
}

{
  "items": [
    {
      "created_at": "2023-11-07T05:31:56Z",
      "modified_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "granted_at": "2023-11-07T05:31:56Z",
      "is_granted": true,
      "revoked_at": "2023-11-07T05:31:56Z",
      "is_revoked": true,
      "subscription_id": "<string>",
      "order_id": "<string>",
      "customer_id": "<string>",
      "user_id": "<string>",
      "benefit_id": "<string>",
      "customer": {
        "created_at": "2023-11-07T05:31:56Z",
        "modified_at": "2023-11-07T05:31:56Z",
        "id": "<string>",
        "metadata": {},
        "email": "<string>",
        "email_verified": true,
        "name": "<string>",
        "billing_address": {
          "line1": "<string>",
          "line2": "<string>",
          "postal_code": "<string>",
          "city": "<string>",
          "state": "<string>",
          "country": "<string>"
        },
        "tax_id": [
          "<any>"
        ],
        "organization_id": "<string>",
        "avatar_url": "<string>"
      },
      "properties": {
        "account_id": "<string>",
        "guild_id": "<string>",
        "role_id": "<string>"
      }
    }
  ],
  "pagination": {
    "total_count": 123,
    "max_page": 123
  }
}

Core API

Customer Portal API

Webhook Events

OAuth 2.0 API

List Benefit Grants

Authorizations

Path Parameters

Query Parameters

Response