recurly-client-0.1.0.0: Client for Recurly subscription management
Safe HaskellSafe-Inferred
LanguageHaskell2010

RecurlyClient.Operations.List_accounts

Description

Contains the different functions to run the operation list_accounts

Synopsis

Documentation

list_accounts Source #

Arguments

:: forall m. MonadHTTP m 
=> List_accountsParameters

Contains all available parameters of this operation (query and path parameters)

-> ClientT m (Response List_accountsResponse)

Monadic computation which returns the result of the operation

GET /accounts

See the Pagination Guide to learn how to use pagination in the API and Client Libraries.

data List_accountsParameters Source #

Defines the object schema located at paths./accounts.GET.parameters in the specification.

Constructors

List_accountsParameters 

Fields

  • list_accountsParametersQueryBegin_time :: Maybe JsonDateTime

    queryBegin_time: Represents the parameter named 'begin_time'

    Inclusively filter by begin_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.

  • list_accountsParametersQueryEmail :: Maybe Text

    queryEmail: Represents the parameter named 'email'

    Filter for accounts with this exact email address. A blank value will return accounts with both `null` and `""` email addresses. Note that multiple accounts can share one email address.

  • list_accountsParametersQueryEnd_time :: Maybe JsonDateTime

    queryEnd_time: Represents the parameter named 'end_time'

    Inclusively filter by end_time when `sort=created_at` or `sort=updated_at`. **Note:** this value is an ISO8601 timestamp. A partial timestamp that does not include a time zone will default to UTC.

  • list_accountsParametersQueryIds :: Maybe [Text]

    queryIds: Represents the parameter named 'ids'

    Filter results by their IDs. Up to 200 IDs can be passed at once using commas as separators, e.g. `ids=h1at4d57xlmy,gyqgg0d3v9n1,jrsm5b4yefg6`.

    • *Important notes:**
    • The `ids` parameter cannot be used with any other ordering or filtering parameters (`limit`, `order`, `sort`, `begin_time`, `end_time`, etc)
    • Invalid or unknown IDs will be ignored, so you should check that the results correspond to your request.
    • Records are returned in an arbitrary order. Since results are all returned at once you can sort the records yourself.
  • list_accountsParametersQueryLimit :: Maybe Int

    queryLimit: Represents the parameter named 'limit'

    Limit number of records 1-200.

    Constraints:

    • Maxium of 200.0
    • Minimum of 1.0
  • list_accountsParametersQueryOrder :: Maybe List_accountsParametersQueryOrder

    queryOrder: Represents the parameter named 'order'

    Sort order.

  • list_accountsParametersQueryPast_due :: Maybe List_accountsParametersQueryPast_due

    queryPast_due: Represents the parameter named 'past_due'

    Filter for accounts with an invoice in the `past_due` state.

  • list_accountsParametersQuerySort :: Maybe List_accountsParametersQuerySort

    querySort: Represents the parameter named 'sort'

    Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.

  • list_accountsParametersQuerySubscriber :: Maybe Bool

    querySubscriber: Represents the parameter named 'subscriber'

    Filter for accounts with or without a subscription in the `active`, `canceled`, or `future` state.

data List_accountsParametersQueryOrder Source #

Defines the enum schema located at paths./accounts.GET.parameters.properties.queryOrder in the specification.

Represents the parameter named 'order'

Sort order.

Constructors

List_accountsParametersQueryOrderOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

List_accountsParametersQueryOrderTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

List_accountsParametersQueryOrderEnumAsc

Represents the JSON value "asc"

List_accountsParametersQueryOrderEnumDesc

Represents the JSON value "desc"

data List_accountsParametersQueryPast_due Source #

Defines the enum schema located at paths./accounts.GET.parameters.properties.queryPast_due in the specification.

Represents the parameter named 'past_due'

Filter for accounts with an invoice in the `past_due` state.

Constructors

List_accountsParametersQueryPast_dueOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

List_accountsParametersQueryPast_dueTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

List_accountsParametersQueryPast_dueEnumTrue

Represents the JSON value true

data List_accountsParametersQuerySort Source #

Defines the enum schema located at paths./accounts.GET.parameters.properties.querySort in the specification.

Represents the parameter named 'sort'

Sort field. You *really* only want to sort by `updated_at` in ascending order. In descending order updated records will move behind the cursor and could prevent some records from being returned.

Constructors

List_accountsParametersQuerySortOther Value

This case is used if the value encountered during decoding does not match any of the provided cases in the specification.

List_accountsParametersQuerySortTyped Text

This constructor can be used to send values to the server which are not present in the specification yet.

List_accountsParametersQuerySortEnumCreated_at

Represents the JSON value "created_at"

List_accountsParametersQuerySortEnumUpdated_at

Represents the JSON value "updated_at"

data List_accountsResponse Source #

Represents a response of the operation list_accounts.

The response constructor is chosen by the status code of the response. If no case matches (no specific case for the response code, no range case, no default case), List_accountsResponseError is used.

Constructors

List_accountsResponseError String

Means either no matching case available or a parse error

List_accountsResponse200 AccountList

A list of the site's accounts.

List_accountsResponse400 Error

Invalid or unpermitted parameter.

List_accountsResponse404 Error

Incorrect site ID.

List_accountsResponseDefault Error

Unexpected error.

list_accountsWithConfiguration Source #

Arguments

:: forall m. MonadHTTP m 
=> Configuration

The configuration to use in the request

-> List_accountsParameters

Contains all available parameters of this operation (query and path parameters)

-> m (Response List_accountsResponse)

Monadic computation which returns the result of the operation

GET /accounts

The same as list_accounts but accepts an explicit configuration.

list_accountsRaw Source #

Arguments

:: forall m. MonadHTTP m 
=> List_accountsParameters

Contains all available parameters of this operation (query and path parameters)

-> ClientT m (Response ByteString)

Monadic computation which returns the result of the operation

GET /accounts

The same as list_accounts but returns the raw ByteString.

list_accountsWithConfigurationRaw Source #

Arguments

:: forall m. MonadHTTP m 
=> Configuration

The configuration to use in the request

-> List_accountsParameters

Contains all available parameters of this operation (query and path parameters)

-> m (Response ByteString)

Monadic computation which returns the result of the operation

GET /accounts

The same as list_accounts but accepts an explicit configuration and returns the raw ByteString.