Get Account Benefits

get

https://s3partnerapi-staging.solutran.com/2.2/accounts/{id}/benefits

Returns a collection of Benefits for the account specified.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The id of the account to return benefits for

Query Params

string

The unique benefit identifier to filter by.

Status

string

The benefit status to filter by. Can include multiple comma-separated values.
Automatically wrapped in parentheses for proper query formatting.

BenefitLevel

string

The benefit level classification to filter by.

PromotionId

int32

The promotion identifier to filter benefits by associated promotion.

DefaultSort

string

The default sorting criteria for benefit searches, ordered by benefit identifier.

AccountId

int64

The account identifier for internal filtering. Not included in query string.

ProgramId

string

The program identifier.

IncludeActiveStatus

boolean

Indicates whether active status benefits are included in the search results.
Set internally based on Status property.

IncludeFutureStatus

boolean

Indicates whether future status benefits are included in the search results.
Set internally based on Status property.

IncludeExpiredStatus

boolean

Indicates whether expired status benefits are included in the search results.
Set internally based on Status property.

IncludeInternalBenefits

boolean

Indicates whether internal benefits should be included in the search results.

SearchCriteria

string

Generates a query string representation of the search criteria.
Automatically formats Status parameter with parentheses for proper query syntax.
Only includes parameters that have non-null, non-empty, or non-zero values.

PartnerId

string

Optional partner identifier for the request context.

Include

string

A comma-separated list of related resources to include in the response. Not used for balance inquiry endpoint.

Allowed values for this resource: issuances, transactions. Multiple values can be comma-separated.

Path

string

The API endpoint path for the current request.
Used internally for request tracking and logging purposes.

TotalCount

int32

The total number of records available for the search criteria.
May be hidden from serialization based on HideTotals setting.

Size

int32

The actual number of records returned in the current response.

Offset

int32

The starting position (zero-based) for the current page of results.

Limit

int32

The maximum number of records to return per page.
Default value is 100 records.

Sort

string

The sorting criteria for the current request.
Used internally for query processing and not included in JSON serialization.

MoreExist

boolean

Indicates whether more results exist beyond the current page.
Automatically calculated based on TotalCount, Limit, and Offset unless explicitly overridden.

HideTotals

boolean

Controls whether total count information should be hidden from the response.
Used internally for performance optimization when total counts are expensive to calculate.

SummaryData

string

Additional summary data that can be included with the response.
Used for aggregated information or custom metadata specific to the search results.

programId

int32

ProgramId

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

204

No Content

200OK

400Bad Request

401Unauthorized

403Forbidden

422Unprocessable Content