The ANI is Automatic Number Identification. It is used by the phone carriers to determine the originating fax or telephone number for any call. ANI is different, conceptually and technically, from caller ID service. A caller’s telephone number and line type are captured by ANI service even if caller ID blocking is activated.
When you set your ANI in an API call please set the number to your fax number with no spaces or punctuation.
If you set it to an invalid number, the receiver may block it as invalid or spam. If you are testing your API, and you can’t get the receiving fax line to accept the call, it could be because their carrier is blocking invalid ANI.
CSID is Called Subscriber Identification (abbreviated CSID), and is a fax number that identifies the specific fax machine sending the fax. A CSID is not required in all cases, but it is a good practice to set so that your fax machine will not get blocked for being spam or unknown.
In some cases, one would want to set the CSID to another number if you want to have the receiver send responses to another number. Think of it as a REPLY TO field on email. If one has many outbound fax lines, but one wants people to fax back to a specific return fax number, one could set the CSID to the primary inbound line so it appears the fax came from that number.
CSID is a string that identifies a sending fax machine. This data is transmitted as part of the fax protocol when the fax transmission is negotiated. This identifier can contain numbers, letters and punctuation. Often it will contain the sending fax number along with a company name. “Acme Inc. (303) 555-1212” for instance. Again this is part of the fax protocol and is completely separate from ANI.
In summary, when sending faxes with the API it is important to set these values correctly and not just mash numbers in or use placeholders. Many failed test faxes fail because of invalid ANIs.