Skip to the content
Agoo Help

Test the Check API

Build and test your integration with a test key and the published test values, one for every kind of answer, free and never billed.

  • Updated 11 November 2026
  • 1 min read
  1. Make a Test key under Keys in your partner area.
  2. Read The Test Values on agoo.reviews/partners, or in the developer docs.
  3. Check each test value from your system with the test key, and make sure it handles every kind of answer: no record, an official contact, confirmed reports and an official warning.

  4. When it's ready, make a Live key and swap it in.

Good to Know

  • A test key answers only the test values, with fixed answers, so it's never a free real lookup.
  • Test calls are never billed, and they're counted apart from live calls under Usage.
  • The test values include phone numbers, an @handle, websites and merchant names, at least one for each outcome.
  • Test mode is free for every partner, before and after the agreement.

If Something Goes Wrong

  • "Test keys answer only the test values." Check you sent a test value exactly as listed.
  • "That key isn't valid, or it was revoked or has expired." Make a new key.

Was this helpful?

Still Stuck?

Ask in your own words. If it needs a person, we'll bring one in.