When something is unavailable, Signl returns a specific reason rather than a generic failure, so your agent can respond sensibly and you can tell what actually happened. Here is every one you may see, what causes it, and what to do about it.
| Result | What it means | What to do |
|---|---|---|
zero_balance | Only from the older contact lookup tools (find_contacts, enrich_lead), when the account has no credits left for them. It never applies to your sources, which are not charged per person | Ask for the people your sources found instead, or move to a bigger plan for more sources |
enrichment_miss | No verified email could be confirmed for that person | Try another contact at the company. You were not charged |
attempt_cap_reached | The account hit its allowance of contact-lookup attempts for this cycle (on Free, for the life of the account) | Wait for the cycle to reset, or move to a paid plan. The figures are on the fair use page |
signal_not_found | The company or signal referenced no longer exists | Run the search again to get current results |
upgrade_required | The feature is on Pro: Pipeline, Audience, Companies (accounts), the market brief, the competitor radar, Teams, and refresh_person_signals | Move to Pro ($99 a month, or $79 billed yearly), or for person signals use the job change signals derived free at enrichment |
discovery_cap_reached | Live discovery searches hit your plan's limit (Free 10 for the life of the account, paid plans a cap per cycle), or the person-signal refresh budget ran out | Wait for the cycle to reset, or search signals Signl has already collected, which stays free |
| Source limit reached | Adding a source would take the account over its plan's source limit: 15 on Self-serve (older plans: 5 on Starter, 40 on Scale), with a search counting as 2. The message says how many the account uses | Remove or finish a source, move to a bigger plan, or talk to us about a custom plan |
person_signals_unavailable | Person-level signals are not enabled on this deployment | Nothing to fix; the rest of Signl is unaffected |
The two that surprise people
A fair use limit running out is not an error. When your plan's likers or verified emails for the month are used up, nothing fails: likers wait and email lookups wait until the 1st, and comments carry on. See when a plan limit is reached.
attempt_cap_reached is about attempts, not results. Every lookup costs us money whether or not it succeeds, so accounts have an allowance of attempts on the contact lookup tools. Hitting it means a lot of lookups were tried, many of which found nothing. If you see it regularly, the fix is usually a tighter target list rather than a plan change.
If you see something not listed here, email vlad@akyx.digital with what you asked and what came back.