| Standard Carrier Alpha Code® (SCAC®) |
The Search method performs a search and retrieves SCAC information. All the parameters are used for matching the closest set of records that starts with the passed in parameter value(s). For example, passing “AB” will search for all SCAC records that begin with “AB”. Each parameter value helps narrow down the list of matched records. For example, passing “AB” for SCAC and “123” for mcNumber will bring back all records that starts with “AB” and “123” for SCAC and MCNumber, respectively.
At least one of the following parameters should have a value:
- scac
- mcNumber
- dotNumber
- companyName
See the following for more information:
- Method Definition
- Search Method Parameter Name, Description, and Data Type
- Method Result
- Search Method JSON Result
- Search Method Result Definition
- Error Messages
Method Definition
Http Method: POST
Authorization header: Bearer JWT
URL: https://scacapi.scaccode.com/SCACSearch
Search Method Parameter Name, Description, and Data Type
| Parameter Name | Description | Data Type |
| scac | Standard Carrier Alpha Code (SCAC). Can be partial. |
|
| mcNumber | MC Number. Can be partial. |
|
| dotNumber | US DOT Number. Can be partial. |
|
| companyName | Company Name. Can be partial. |
|
| excludeExpiredCode |
Exclude expired SCAC from the search result list. Can be true or false.
|
|
| exactMatch |
Any term entered must be an exact match (but not case-sensitive) to data in the database. For example:
|
|
| page | If the search result has more than 25 hits, the result is broken into multiple pages. Use this parameter to retrieve a specific page from the search result. |
|
| sortField | Identifies which field is to use to sort the search result. |
|
| sortOrder | Identifies the sorting order of the search result. |
|
Method Result
Search Method JSON Result
| Result Status | Result JSON String |
| Success |
{ "items": [ { "companyName": "AKRON & RAILROAD COMPANY", "scac": "ABB", "addressLine1": 340 fake st, "addressLine2": null, "city": "BARBERTON", "stateProvince": "FL", "postalCode": "00000", "countryCode": "USA", "phone": "5555555", "scacEndDate": "2025-01-24T00:00:00", "dbaName": "", "dotNumber": "00000", "mcNumber": "", "isVerified": 0, "status": "Active" }, { "companyName": "BEST CARRIER", "scac": "ABBA", "addressLine1": 123 fake st., "addressLine2": null, "city": "CITY OF INDUSTRY", "stateProvince": "NY", "postalCode": "00000", "countryCode": "USA", "phone": "5555555", "scacEndDate": "2025-04-24T00:00:00", "dbaName": "", "dotNumber": "00000", "mcNumber": "828088", "isVerified": 1, "status": "Expired" } ], "currentPage": 1, "totalCount": 2, "totalPages": 1, "success": true, "errorMessage ": null } |
| Failure |
{ "success": false, "errorMessage ": "string" }
See Error Messages for list of errors |
Search Method Result Definition
| JSON Properties | Description | Data Type |
| Success | Identifies if the method call completed successfully. |
|
| TotalPages | Total Number of pages in search result. |
|
| CurrentPage | Current Page from the search result. |
|
| TotalCount | Total number of hits for the passed in search “keyword”. |
|
| Items |
A single matching SCAC Record. Each SCAC record include the following properties that describe the SCAC.
|
|
| ErrorMessage | Error description. |
|
Error Messages
Error Messages
| Message String |
Page number must be within TotalPage range. Scac length (7) > allowed length (4). There are no results for your search. You can do a partial search by setting exactMatch = false There are no results for your search There was a problem with the query. |