Authentication Overview
The ATC DMV Docs API uses a combination of HTTP Basic Authentication and a URL token parameter. You must include both forms of authentication in your requests.
Two-Factor Authentication: Requests require both Basic Auth headers AND a token in the URL path.
Authentication Methods
1. HTTP Basic Authentication
Include the Authorization header with Base64-encoded credentials:
1
Combine Username and Password
Format: username:password
2
Base64 Encode
Encode the combined string using Base64
3
Add Authorization Header
Prefix with "Basic " and add to request headers
# Example: username "dealer1" with password "secret123"
# Step 1: Combine
dealer1:secret123
# Step 2: Base64 encode
ZGVhbGVyMTpzZWNyZXQxMjM=
# Step 3: Format header
Authorization: Basic ZGVhbGVyMTpzZWNyZXQxMjM=
2. URL Token Parameter
Your API token is passed as part of the URL path:
https://docsvc.autotitling.com/api/Process/RetrieveVehicleDocumentsByToken/{YOUR_TOKEN}
Complete Request Example
HTTP Headers
POST /api/Process/RetrieveVehicleDocumentsByToken/YOUR_API_TOKEN HTTP/1.1
Host: docsvc.autotitling.com
Authorization: Basic ZGVhbGVyMTpzZWNyZXQxMjM=
Content-Type: application/json
Accept: application/xml
cURL Example
curl -X POST "https://docsvc.autotitling.com/api/Process/RetrieveVehicleDocumentsByToken/YOUR_TOKEN" \
-H "Authorization: Basic ZGVhbGVyMTpzZWNyZXQxMjM=" \
-H "Content-Type: application/json" \
-H "Accept: application/xml" \
-d '{"DealerCode":"TEST1","TransactionState":"PA",...}'
Security Warning: Never expose your credentials in client-side code, version control, or logs. Use environment variables or secure credential management.
Request Headers Reference
| Header | Required | Value | Description |
|---|---|---|---|
Authorization |
Yes | Basic {base64} |
Base64 encoded username:password |
Content-Type |
Yes | application/json |
Request body format |
Accept |
Recommended | application/xml |
Expected response format |
Obtaining Credentials
To obtain your API credentials (username, password, and token), contact the ATC API Support team:
- Email: api@autotitling.com
What You'll Receive
- Username for Basic Authentication
- Password for Basic Authentication
- API Token for URL path
- Dealer Code for request payloads
Base URL
| Environment | Base URL |
|---|---|
| Production | https://docsvc.autotitling.com/api/Process |
Error Responses
| Status | Meaning | Resolution |
|---|---|---|
401 Unauthorized |
Invalid or missing credentials | Check your Basic Auth header and token |
403 Forbidden |
Valid credentials but insufficient permissions | Contact ATC to verify account permissions |