What should I do if I receive an API Error?

A Call Authentication API Failure Summary report is available to all INFORM customers in 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

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

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

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

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

Phone number is missing additional vetting

This error indicates that the phone number is in a Sentry enabled program but has not been successfully vetted. Please note that First Orion requires phone numbers in Sentry enabled programs to be vetted at a minimum every 30 days. To resolve this error

1. Verify the aNumber in the request
2. Verify that the number is in the correct program assistance