What should I do if I receive an API Error?

A Call Authentication API Failure Summary report is available in Basic and Advanced Analytics within the Customer Portal and displays the count of different errors encountered. 

Here are descriptions of the possible errors you may receive, and ways to remedy each error. If there are any additional questions, please don’t hesitate to reach out to our support team at enterprisesupport@firstorion.com.

aNumber (Calling Number) not associated with the business/resellerId included in the request

This error indicates that the calling number in the request is not associated with the business or organization for which we received the request from.

1. Verify the number is the request
2. Verify that the number is correctly associated with your business and is in the correct program
3. If you need additional help, contact support at enterprisesupport@firstorion.com

Invalid Phone Number

This error indicates that either the calling number or the number being called within the request is not formatted correctly.

1. Verify the calling number and number being called is entered in E.164 format
2. Remove any special characters or spaces

aNumber (Calling Number) not enabled for Call Authentication

This error indicates that the calling number within the request is not in a Call Authentication program.

1. Check that the calling number is in the appropriate program that includes the Call Authentication Program Type
2. If you need additional help, contact support at enterprisesupport@firstorion.com

aNumber (Calling Number) equals bNumber (Called Number)

This indicates that the calling number and the number being called within the request are the same

1. Update either the calling number or the number being called

Phone number is not approved

This error indicates that the calling number is not in an approved state.

1. Double-check the phone number you entered
2. If you need additional help, contact support at enterprisesupport@firstorion.com

Program schedule has expired

This indicates that the program that contains the calling number within the request is no longer active.

1. Update the program’s scheduled end date to ensure it is active
2. Add the calling number to the appropriate program
3. If you need additional help, contact support at enterprisesupport@firstorion.com

aNumber (Calling Number) is missing

This indicates that the request did not have a calling number.

1. Please ensure a valid calling number is included

Other

This error may indicate that additional research is needed to troubleshoot.

1. Verify the required values are in the request and in the right format. For more information, please see our Call Authentication documentation available within the Developer Portal https://developer.firstorion.com/firstorion-public/reference/callauthentication
2. If this error is observed, please reach out to enterprisesupport@firstorion.com for assistance