Complete reference for all Ascend SDK resources and methods.
- Accounts
- Attachments
- BillableCancelations
- Billables
- CancelationRequests
- CancelationReturns
- Carriers
- Contacts
- CoverageTypes
- FinanceEstimate
- InstallmentPlans
- Installments
- Insureds
- Invoices
- Loans
- OneTimePayments
- OrganizationAccountUsers
- PaymentProposals
- Payouts
- PremiumReducingEndorsements
- Programs
- Refunds
- Returns
- Users
- Wholesalers
Access via: $ascend->accounts()
List Accounts
$ascend->accounts()->list();HTTP Method: GET
Endpoint: /v1/accounts
Create Accounts
$ascend->accounts()->create([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/accounts
Get account
$ascend->accounts()->get('id_value');Parameters:
$id(string, required): Account identifier
HTTP Method: GET
Endpoint: /v1/accounts/{id}
Update account
$ascend->accounts()->update('id_value', [
// data array
]);Parameters:
$id(string, required): Account identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/accounts/{id}
Access via: $ascend->attachments()
Create attachment
$ascend->attachments()->createAttachment([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/attachments
Get attachment
$ascend->attachments()->get('id_value');Parameters:
$id(string, required): The attachment identifier
HTTP Method: GET
Endpoint: /v1/attachments/{id}
Delete Attachments
$ascend->attachments()->delete('id_value');Parameters:
$id(string, required): The attachment identifier
HTTP Method: DELETE
Endpoint: /v1/attachments/{id}
Access via: $ascend->billableCancelations()
Initiate a cancelation for a billable
$ascend->billableCancelations()->cancelBillable('id_value', [
// data array
]);Parameters:
$id(string, required): The billable identifier$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/billables/{id}/cancelation
Access via: $ascend->billables()
List Billables
$ascend->billables()->listBillables([
// query params
]);Parameters:
$program_id(array, optional): Filter by associated program
HTTP Method: GET
Endpoint: /v1/billables
Create Billable
$ascend->billables()->createBillable([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/billables
Get Billable
$ascend->billables()->get('id_value');Parameters:
$id(string, required): The billable identifier
HTTP Method: GET
Endpoint: /v1/billables/{id}
Update Billable
$ascend->billables()->updateBillable('id_value', [
// data array
]);Parameters:
$id(string, required): The billable identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/billables/{id}
Delete Billable
$ascend->billables()->delete('id_value');Parameters:
$id(string, required): The billable identifier
HTTP Method: DELETE
Endpoint: /v1/billables/{id}
Create Billables
$ascend->billables()->bulkCreateBillables([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/bulk_billables
Access via: $ascend->cancelationRequests()
List Cancelation Requests
$ascend->cancelationRequests()->get('billable_id_value');Parameters:
$billable_id(string, required): The billable identifier
HTTP Method: GET
Endpoint: /v1/billables/{billable_id}/cancelations
Create a Cancelation Request
$ascend->cancelationRequests()->createCancelationRequest('billable_id_value', [
// data array
]);Parameters:
$billable_id(string, required): The billable identifier$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/billables/{billable_id}/cancelations
Get a Cancelation Request
$ascend->cancelationRequests()->get('billable_id_value', 'id_value');Parameters:
$billable_id(string, required): The billable identifier$id(string, required): The cancelation request identifier
HTTP Method: GET
Endpoint: /v1/billables/{billable_id}/cancelations/{id}
Update a Cancelation Request
$ascend->cancelationRequests()->updateCancelationRequest('billable_id_value', 'id_value', [
// data array
]);Parameters:
$billable_id(string, required): The billable identifier$id(string, required): The cancelation request identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/billables/{billable_id}/cancelations/{id}
Access via: $ascend->cancelationReturns()
List Cancelation Returns
$ascend->cancelationReturns()->list([
// query params
]);Parameters:
$program_id(array, optional): The program identifier
HTTP Method: GET
Endpoint: /v1/cancelation_returns
Create Cancelation Return
$ascend->cancelationReturns()->createCancelationReturns([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/cancelation_returns
Get Cancelation Return
$ascend->cancelationReturns()->get('id_value');Parameters:
$id(string, required): The cancelation return identifier
HTTP Method: GET
Endpoint: /v1/cancelation_returns/{id}
Update Cancelation Returns
$ascend->cancelationReturns()->updateCancelationReturn('id_value', [
// data array
]);Parameters:
$id(string, required): The cancelation return identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/cancelation_returns/{id}
Access via: $ascend->carriers()
List Carriers
$ascend->carriers()->listCarriers([
// query params
], [
// query params
]);Parameters:
$page(array, optional): The requested page number. Default page number is 0.$search_query(array, optional): The term used to search. An empty query can be used to fetch all carriers sorted by the carrier name in alphabetical order.
HTTP Method: GET
Endpoint: /v1/carriers
Access via: $ascend->contacts()
List Contacts
$ascend->contacts()->list([
// query params
], [
// query params
], [
// query params
]);Parameters:
$email(array, optional): Filter by associated email$contact_type(array, optional): Filter by contact type$page(array, optional): Page number
HTTP Method: GET
Endpoint: /v1/contacts
Create Contact
$ascend->contacts()->create([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/contacts
Get Contact
$ascend->contacts()->get('id_value');Parameters:
$id(string, required)
HTTP Method: GET
Endpoint: /v1/contacts/{id}
Update contact
$ascend->contacts()->update('id_value', [
// data array
]);Parameters:
$id(string, required)$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/contacts/{id}
Access via: $ascend->coverageTypes()
List CoverageTypes
$ascend->coverageTypes()->listCoverageTypes([
// query params
]);Parameters:
$page(array, optional)
HTTP Method: GET
Endpoint: /v1/coverage_types
Access via: $ascend->financeEstimate()
Create FinanceEstimate
$ascend->financeEstimate()->create([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/finance_estimates
Access via: $ascend->installmentPlans()
Get installment plan
$ascend->installmentPlans()->get('id_value');Parameters:
$id(string, required): The id of the installment plan
HTTP Method: GET
Endpoint: /v1/installment_plans/{id}
Archive Installment Plan
$ascend->installmentPlans()->archiveInstallmentPlan('id_value');Parameters:
$id(string, required): The id of the installment plan
HTTP Method: DELETE
Endpoint: /v1/installment_plans/{id}
Update Installment Plan
$ascend->installmentPlans()->updateInstallmentPlan('id_value', [
// data array
]);Parameters:
$id(string, required): The id of the installment plan$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/installment_plans/{id}
Create installment plan
$ascend->installmentPlans()->create([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/installment_plans
Cancel Installment Plan
$ascend->installmentPlans()->cancelInstallmentPlan('id_value');Parameters:
$id(string, required): The id of the installment plan
HTTP Method: POST
Endpoint: /v1/installment_plans/{id}/cancel
Notify User
$ascend->installmentPlans()->sendInstallmentPlanReminder('id_value');Parameters:
$id(string, required): The id of the installment plan
HTTP Method: POST
Endpoint: /v1/installment_plans/{id}/send
Access via: $ascend->installments()
Get installment
$ascend->installments()->get('id_value');Parameters:
$id(string, required): Id of the installment
HTTP Method: GET
Endpoint: /v1/installments/{id}
Update installment
$ascend->installments()->update('id_value', [
// data array
]);Parameters:
$id(string, required): Id of the installment$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/installments/{id}
Access via: $ascend->insureds()
Create Insured
$ascend->insureds()->createInsured([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/insureds
List Insureds
$ascend->insureds()->listInsureds([
// query params
], [
// query params
], [
// query params
]);Parameters:
$page(array, optional)$email(array, optional): Filter by associated email$business_name(array, optional): Search by business name
HTTP Method: GET
Endpoint: /v1/insureds
Get Insured
$ascend->insureds()->get('id_value');Parameters:
$id(string, required): The insured identifier
HTTP Method: GET
Endpoint: /v1/insureds/{id}
Delete Insured
$ascend->insureds()->delete('id_value');Parameters:
$id(string, required): The insured identifier
HTTP Method: DELETE
Endpoint: /v1/insureds/{id}
Update Insured
$ascend->insureds()->updateInsured('id_value', [
// data array
]);Parameters:
$id(string, required): The insured identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/insureds/{id}
Access via: $ascend->invoices()
List Invoices
$ascend->invoices()->listInvoices([
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
]);Parameters:
$program_id(array, optional): Filter by associated program$program_id[](array, optional): Filter by associated programs. Include in the query multiple times to filter for multiple programs.$page(array, optional): Page number for paginating results. Default is 1.$billable_id(array, optional): Filter by associated billable$insured_id(array, optional): Filter for invoices to be paid by associated insured$product_type(array, optional)$due_date_start(array, optional)$due_date_end(array, optional)$paid_at_start(array, optional)$paid_at_end(array, optional)
HTTP Method: GET
Endpoint: /v1/invoices
Create invoice
$ascend->invoices()->createInvoice([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/invoices
Get Invoice
$ascend->invoices()->get('id_value');Parameters:
$id(string, required): The invoice identifier
HTTP Method: GET
Endpoint: /v1/invoices/{id}
Update invoice
$ascend->invoices()->updateInvoice('id_value', [
// data array
]);Parameters:
$id(string, required): The invoice identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/invoices/{id}
Void invoice
$ascend->invoices()->voidInvoice('id_value');Parameters:
$id(string, required): The invoice identifier
HTTP Method: DELETE
Endpoint: /v1/invoices/{id}
Access via: $ascend->loans()
List Loans
$ascend->loans()->listLoans([
// query params
], [
// query params
], [
// query params
]);Parameters:
$page(array, optional)$status(array, optional): Filter by associated status$program_id(array, optional): Filter by associated program
HTTP Method: GET
Endpoint: /v1/loans
Get Loan
$ascend->loans()->get('id_value');Parameters:
$id(string, required): The loan identifier
HTTP Method: GET
Endpoint: /v1/loans/{id}
Access via: $ascend->oneTimePayments()
List One Time Payments
$ascend->oneTimePayments()->listOneTimePayments([
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
]);Parameters:
$insured_id(array, optional)$organization_account_id(array, optional)$due_date_start(array, optional)$due_date_end(array, optional)$paid_at_start(array, optional)$paid_at_end(array, optional)$page(array, optional): Page number for paginating results. Default is 1.
HTTP Method: GET
Endpoint: /v1/one_time_payments
Create One Time Payment
$ascend->oneTimePayments()->createOneTimePayment([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/one_time_payments
Get One Time Payment
$ascend->oneTimePayments()->get('id_value');Parameters:
$id(string, required): The one time payment identifier
HTTP Method: GET
Endpoint: /v1/one_time_payments/{id}
Update One Time Payment
$ascend->oneTimePayments()->updateOneTimePayment('id_value', [
// data array
]);Parameters:
$id(string, required): The one time payment identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/one_time_payments/{id}
Void One Time Payment
$ascend->oneTimePayments()->voidOneTimePayment('id_value');Parameters:
$id(string, required): The one time payment identifier
HTTP Method: DELETE
Endpoint: /v1/one_time_payments/{id}
Notify User
$ascend->oneTimePayments()->sendOneTimePaymentReminder('id_value');Parameters:
$id(string, required): The id of the one_time_payment
HTTP Method: POST
Endpoint: /v1/one_time_payments/{id}/send
Access via: $ascend->organizationAccountUsers()
List account users
$ascend->organizationAccountUsers()->listOrgAccountUsers('account_id_value', [
// query params
], [
// query params
]);Parameters:
$account_id(string, required)$page(array, optional)$email(array, optional)
HTTP Method: GET
Endpoint: /v1/organization_accounts/{account_id}/users
Create account user
$ascend->organizationAccountUsers()->createOrgAccountUser('account_id_value', [
// data array
]);Parameters:
$account_id(string, required)$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/organization_accounts/{account_id}/users
Get account user
$ascend->organizationAccountUsers()->get('account_id_value', 'id_value');Parameters:
$account_id(string, required)$id(string, required)
HTTP Method: GET
Endpoint: /v1/organization_accounts/{account_id}/users/{id}
Access via: $ascend->paymentProposals()
Generate payment proposal document for a program
$ascend->paymentProposals()->createPaymentProposal([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/payment_proposals
Access via: $ascend->payouts()
List Payouts
$ascend->payouts()->listPayouts([
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
]);Parameters:
$program_id(array, optional): Filter by associated program$page(array, optional)$status(array, optional): Filter by status$paid_at(array, optional): Filter by paid_at date range. The date should be defined as a ISO-8601 date.$created_at(array, optional): Filter by created_at date range. The date should be defined as a ISO-8601 date.
HTTP Method: GET
Endpoint: /v1/payouts
Access via: $ascend->premiumReducingEndorsements()
Create premium reducing endorsement
$ascend->premiumReducingEndorsements()->create([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/premium_reducing_endorsements
Show a premium reducing endorsement
$ascend->premiumReducingEndorsements()->get('id_value');Parameters:
$id(string, required): Endorsement ID
HTTP Method: GET
Endpoint: /v1/premium_reducing_endorsements/{id}
Update a premium reducing endorsement
$ascend->premiumReducingEndorsements()->update('id_value', [
// data array
]);Parameters:
$id(string, required): Endorsement ID$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/premium_reducing_endorsements/{id}
delete premium reducing endorsement
$ascend->premiumReducingEndorsements()->delete('id_value');Parameters:
$id(string, required): Endorsement ID
HTTP Method: DELETE
Endpoint: /v1/premium_reducing_endorsements/{id}
Access via: $ascend->programs()
List Programs
$ascend->programs()->listPrograms([
// query params
], [
// query params
], [
// query params
]);Parameters:
$page(array, optional)$insured_id(array, optional): Filter by associated insured$purchased_at(array, optional): Filters by purchased date. The date should be defined as a ISO-8601 date.
HTTP Method: GET
Endpoint: /v1/programs
Create Program
$ascend->programs()->createProgram([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/programs
Get Program
$ascend->programs()->get('id_value', [
// query params
]);Parameters:
$id(string, required): The program identifier$include_archived(array, optional): Include archived programs
HTTP Method: GET
Endpoint: /v1/programs/{id}
Update program
$ascend->programs()->updateProgram('id_value', [
// data array
]);Parameters:
$id(string, required): The program identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/programs/{id}
Archive Program
$ascend->programs()->delete('id_value');Parameters:
$id(string, required): The program identifier
HTTP Method: DELETE
Endpoint: /v1/programs/{id}
Notify User
$ascend->programs()->notifyInsured('id_value');Parameters:
$id(string, required): the id of the program
HTTP Method: POST
Endpoint: /v1/programs/{id}/send
Unarchive program
$ascend->programs()->unarchiveProgram('id_value');Parameters:
$id(string, required): The id of the program
HTTP Method: POST
Endpoint: /v1/programs/{id}/unarchive
Loan Payoff Estimate
$ascend->programs()->createLoanPayoffEstimate('id_value');Parameters:
$id(string, required): the id of the program
HTTP Method: POST
Endpoint: /v1/programs/{id}/loan_payoff_estimate
Access via: $ascend->refunds()
List Refunds
$ascend->refunds()->list([
// query params
], [
// query params
], [
// query params
], [
// query params
], [
// query params
]);Parameters:
$billable_id(array, optional): Filter by associated billable$program_id(array, optional): Filter by associated program$invoice_id(array, optional): Filter by associated invoice$paid_at(array, optional): Filter by paid_at date range. The date should be defined as a ISO-8601 date.$created_at(array, optional): Filter by created_at date range. The date should be defined as a ISO-8601 date.
HTTP Method: GET
Endpoint: /v1/refunds
Access via: $ascend->returns()
Get returns
$ascend->returns()->get('installment_plan_id_value');Parameters:
$installment_plan_id(string, required)
HTTP Method: GET
Endpoint: /v1/installment_plans/{installment_plan_id}/returns
Create a return
$ascend->returns()->create('installment_plan_id_value', [
// data array
]);Parameters:
$installment_plan_id(string, required)$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/installment_plans/{installment_plan_id}/returns
Get a return
$ascend->returns()->get('installment_plan_id_value', 'return_id_value');Parameters:
$installment_plan_id(string, required)$return_id(string, required)
HTTP Method: GET
Endpoint: /v1/installment_plans/{installment_plan_id}/returns/{return_id}
Update a return
$ascend->returns()->update('installment_plan_id_value', 'return_id_value', [
// data array
]);Parameters:
$installment_plan_id(string, required)$return_id(string, required)$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/installment_plans/{installment_plan_id}/returns/{return_id}
Void return
$ascend->returns()->delete('installment_plan_id_value', 'return_id_value');Parameters:
$installment_plan_id(string, required)$return_id(string, required)
HTTP Method: DELETE
Endpoint: /v1/installment_plans/{installment_plan_id}/returns/{return_id}
Get returns
$ascend->returns()->get('one_time_payment_id_value');Parameters:
$one_time_payment_id(string, required)
HTTP Method: GET
Endpoint: /v1/one_time_payments/{one_time_payment_id}/returns
Create a return
$ascend->returns()->create('one_time_payment_id_value', [
// data array
]);Parameters:
$one_time_payment_id(string, required)$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/one_time_payments/{one_time_payment_id}/returns
Get a return
$ascend->returns()->get('one_time_payment_id_value', 'return_id_value');Parameters:
$one_time_payment_id(string, required)$return_id(string, required)
HTTP Method: GET
Endpoint: /v1/one_time_payments/{one_time_payment_id}/returns/{return_id}
Update a return
$ascend->returns()->update('one_time_payment_id_value', 'return_id_value', [
// data array
]);Parameters:
$one_time_payment_id(string, required)$return_id(string, required)$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/one_time_payments/{one_time_payment_id}/returns/{return_id}
Void return
$ascend->returns()->delete('one_time_payment_id_value', 'return_id_value');Parameters:
$one_time_payment_id(string, required)$return_id(string, required)
HTTP Method: DELETE
Endpoint: /v1/one_time_payments/{one_time_payment_id}/returns/{return_id}
List Cancelation Returns
$ascend->returns()->list([
// query params
]);Parameters:
$cancelation_id(array, optional): The cancelation request identifier
HTTP Method: GET
Endpoint: /v1/returns
Create Return
$ascend->returns()->createReturn([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/returns
Get a Return
$ascend->returns()->get('id_value');Parameters:
$id(string, required): The cancelation return identifier
HTTP Method: GET
Endpoint: /v1/returns/{id}
Update Cancelation Returns
$ascend->returns()->updateReturn('id_value', [
// data array
]);Parameters:
$id(string, required): The cancelation return identifier$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/returns/{id}
Delete a Cancelation Return
$ascend->returns()->delete('id_value');Parameters:
$id(string, required): The cancelation return identifier
HTTP Method: DELETE
Endpoint: /v1/returns/{id}
Access via: $ascend->users()
List Users
$ascend->users()->listUsers([
// query params
], [
// query params
]);Parameters:
$page(array, optional)$email(array, optional)
HTTP Method: GET
Endpoint: /v1/users
Create User
$ascend->users()->createUser([
// data array
]);Parameters:
$data(array, required): Request body data
HTTP Method: POST
Endpoint: /v1/users
Get User
$ascend->users()->get('id_value');Parameters:
$id(string, required)
HTTP Method: GET
Endpoint: /v1/users/{id}
Update User
$ascend->users()->updateUser('id_value', [
// data array
]);Parameters:
$id(string, required)$data(array, required): Request body data
HTTP Method: PATCH
Endpoint: /v1/users/{id}
Access via: $ascend->wholesalers()
List Wholesalers
$ascend->wholesalers()->listWholesalers([
// query params
], [
// query params
]);Parameters:
$page(array, optional): The requested page number. Default page number is 0.$search_query(array, optional): The term used to search. An empty query can be used to fetch all wholesalers sorted by the wholesaler name in alphabetical order.
HTTP Method: GET
Endpoint: /v1/wholesalers