Table of Contents

Class PaginatedCategoryClient

Namespace
Crews.PlanningCenter.Api.Registrations.V2025_05_01
Assembly
Crews.PlanningCenter.Api.dll

Client for interacting with Category collection resources.

public class PaginatedCategoryClient : PaginatedResourceClient<Category, CategoryResource, CategoryCollectionResponse, CategoryResponse>
Inheritance
PaginatedCategoryClient
Inherited Members

Constructors

PaginatedCategoryClient(HttpClient, Uri)

Client for interacting with Category collection resources.

public PaginatedCategoryClient(HttpClient httpClient, Uri uri)

Parameters

httpClient HttpClient
uri Uri

Methods

AddCustomParameter(string, string)

Adds a custom query parameter to the request URI.

public PaginatedCategoryClient AddCustomParameter(string parameter, string value)

Parameters

parameter string

The name of the query parameter.

value string

The value of the query parameter.

Returns

PaginatedCategoryClient

The current PaginatedCategoryClient instance.

ClearParameters()

Removes the entire query string from the request URI.

public PaginatedCategoryClient ClearParameters()

Returns

PaginatedCategoryClient

The current PaginatedCategoryClient instance.

Filter(string)

Adds a filter query parameter to the request.

public PaginatedCategoryClient Filter(string filter)

Parameters

filter string

The filter criteria.

Returns

PaginatedCategoryClient

The current PaginatedCategoryClient instance.

Remarks

See Planning Center API documentation for details on supported filter values for this resource.

GetAsync(CancellationToken)

Fetches a paginated list of Category resources asynchronously.

public Task<CategoryCollectionResponse> GetAsync(CancellationToken cancellationToken = default)

Parameters

cancellationToken CancellationToken

A token to monitor for cancellation requests.

Returns

Task<CategoryCollectionResponse>

A task representing the asynchronous operation, containing a paginated list of Category resources.

Exceptions

JsonApiException

Thrown when the HTTP response indicates a failure status code.

Offset(int)

Sets the item offset in the paginated response.

public PaginatedCategoryClient Offset(int count)

Parameters

count int

The number of items to skip.

Returns

PaginatedCategoryClient

The current PaginatedCategoryClient instance.

PerPage(int)

Sets the number of items to be returned per page in the paginated response.

public PaginatedCategoryClient PerPage(int count)

Parameters

count int

The number of items to be returned per page.

Returns

PaginatedCategoryClient

The current PaginatedCategoryClient instance.

WithId(string)

Creates a new instance of a Category client for a specific resource ID.

public CategoryClient WithId(string id)

Parameters

id string

The ID of the resource to create a client for.

Returns

CategoryClient

A new instance of the resource client for the specified resource ID.