API Index

http://localhost:3000

Reference topics

429 Too Many Requests - reaching rate limit

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Try again in 60 seconds",
  "status": 429,
  "retry_after": 60
}

500 Internal Server Error - something is wrong with the server

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred. Please try again later",
  "status": 500
}

503 Service Unavailable - during PawFinder Maintenance

{
  "error": "Service Unavailable",
  "message": "API is temporarily unavailable for maintenance",
  "status": 503
}

The PawFinder API currently doesn’t use URI versioning, but plans to.

Future version support policy:

PawFinder supports all major versions for 24 months after a new version releases.
Deprecated endpoints include a Sunset header indicating end-of-life date.
PawFinder introduces breaking changes in major version increments.
Minor updates and bug fixes won’t require version changes.