resumeUrl values.
Supported resume formats
The API currently supports these resume formats:| Format | Extension | Content-Type |
|---|---|---|
.pdf | application/pdf | |
| Microsoft Word | .doc | application/msword |
| Microsoft Word | .docx | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
If your ATS supports multiple formats, prefer PDF for the most predictable rendering.
File size limit
| Limit | Value |
|---|---|
| Maximum file size | 50 MB |
RESUME_TOO_LARGE.
Resume URL requirements
YourresumeUrl must be:
HTTPS
Publicly accessible without authentication
A direct download of the file
URL expiry
The resume is downloaded during the scoring submission request. Set your URL expiry long enough to cover retries and operational delays.| Setting | Recommendation |
|---|---|
| Minimum expiry | 10 minutes |
| Recommended expiry | 1 hour or more |
Generating pre-signed URLs
- AWS S3
- Google Cloud Storage
- Azure Blob Storage
Common issues
RESUME_FETCH_FAILED
RESUME_FETCH_FAILED
Causes:
- URL expired
- URL not publicly accessible
- Storage returned a non-2xx response
- Test the URL in an incognito browser window
- Increase expiry
- Ensure the URL returns the actual file bytes
VALIDATION_ERROR: Unsupported file type
VALIDATION_ERROR: Unsupported file type
Cause: The response Content-Type is not supported.What to do:
- Ensure the URL returns PDF, DOC, or DOCX content
- If your storage is returning
application/octet-stream, configure correct Content-Type metadata
RESUME_TOO_LARGE
RESUME_TOO_LARGE
Cause: The file exceeds 50 MB.What to do:
- Ask the candidate for a smaller file
- Convert to PDF and compress
RESUME_ENCRYPTED
RESUME_ENCRYPTED
Cause: The PDF is password-protected or encrypted.What to do:
- Ask the candidate to provide an unprotected PDF
- Remove password protection before uploading
RESUME_EMPTY
RESUME_EMPTY
Cause: The file is empty or contains no extractable content.What to do:
- Verify the file was uploaded correctly
- Check that the resume contains actual content
RESUME_PARSE_FAILED
RESUME_PARSE_FAILED
Cause: The file is not a valid PDF, DOC, or DOCX despite the Content-Type header.What to do:
- Verify the file opens correctly in a PDF viewer or Word
- Check that the URL returns the actual file, not an error page
- If your storage returned an HTML error page with
application/pdfContent-Type, fix the storage configuration