{"openapi":"3.2.0","info":{"title":"Truecaller API","description":"Truecaller API — Phone & Caller Information Verification Service on JoJ API  Please note: This is an unofficial, third-party API service and is not affiliated with, endorsed, or operated by Truecaller.  Are you looking for a reliable way to identify callers and verify phone number data? We are now offering our Truecaller API service, officially hosted and available for subscription on JoJ API!  This API provides a seamless, practical, and highly efficient solution for checking and validating phone number information, helping businesses, developers, and platforms identify who is on the other end of a call or registration before proceeding with transactions or interactions. By using this service, you can significantly mitigate risk, reduce fraudulent activities, and prevent input errors on your platforms","version":"1.0.0"},"servers":[{"url":"https://truecaller-api.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://truecaller-api.jojapi.net/_jojapi/agent/plans","discovery_url":"https://truecaller-api.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/truecaller-api","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/truecaller/{phone}":{"get":{"operationId":"get_truecaller_phone","summary":"Phone Numbers","description":"To perform a check, simply provide the phone number with its country code","responses":{"200":{"description":"Successful response","content":{"application/json":{"examples":{"ValidNumber":{"summary":"ValidNumber — listed on Truecaller. Number found and registered on Truecaller (Quota deducted).","description":"ValidNumber — listed on Truecaller. Number found and registered on Truecaller (Quota deducted).","value":{"data":[{"id":"TP/ShygSUt4m9+L49uEi5Q==","name":"Annie Kunke","image":"https://images-noneu.truecallerstatic.com/myview/1/fb4b6650dafb06274163efa5b40b0659/1","access":"PUBLIC","work":"","enhanced":true,"phones":[{"e164Format":"+233552188188","numberType":"MOBILE","nationalFormat":"055 218 8188","dialingCode":233,"countryCode":"GH","carrier":"M - MTN","type":""}],"addresses":[{"address":"Ghana ⸱ 11:17","countryCode":"GH","timeZone":"","type":"address"}],"internetAddresses":[{"id":"kunkeannie@gmail.com","service":"email","caption":"Annie Kunke","type":"internetAddress"}],"badges":["user"],"tags":[],"cacheTtl":1296000000,"sources":[],"searchWarnings":[],"surveys":[{"id":"0905a705-3c8c-48ab-a4a6-001ce0b20566","frequency":86400,"passthroughData":"eyAiNCI6ICJwZiIsICIyMSI6ICIwIiwgIjIzIjogIjM3NzgxY2M3LTQzZWUtNDhjZS1hOWMxLWM3ZGRiODZiMGNkZSIsICIzIjogIjk3MjUwNjQ2MjM2NSIsICI4IjogIjAiLCAiMiI6ICJOb2FtIExlaWJvdml0Y2giLCAiMjIiOiAiMCIgfQ==","perNumberCooldown":31536000,"dynamicContentAccessKey":""},{"id":"4eb9afcf-f36e-430d-86f9-4f72ca091f91","frequency":86400,"passthroughData":"eyAiNCI6ICJwZiIsICIyMSI6ICIwIiwgIjIzIjogIjdkZmJlNDk4LWQ4MDUtNGIwZS1iZjM3LTUwZjhmZTliM2ZmYiIsICIzIjogIjk3MjUwNjQ2MjM2NSIsICI4IjogIjAiLCAiMiI6ICJOb2FtIExlaWJvdml0Y2giLCAiMjIiOiAiMCIgfQ==","perNumberCooldown":31536000,"dynamicContentAccessKey":""},{"id":"306103a9-9c38-4bc9-8ca7-6e9c469ba8bf","frequency":0,"passthroughData":"eyAiNCI6ICJwZiIsICIyMSI6ICIwIiwgIjIzIjogImJmOWYxYTM3LWVjMDgtNDZlMS04MWEzLWJhZDI5ZDBkOGE4ZSIsICIzIjogIjk3MjUwNjQ2MjM2NSIsICI4IjogIjAiLCAiMiI6ICJOb2FtIExlaWJvdml0Y2giLCAiMjIiOiAiMCIgfQ==","perNumberCooldown":0,"dynamicContentAccessKey":""}],"commentsStats":{"showComments":false},"manualCallerIdPrompt":false,"isFraud":false,"ns":0}],"provider":"ss-nu","stats":{"sourceStats":[]}}},"NotFound":{"summary":"Valid Number — Unlisted on Truecaller. Number found but unlisted in Truecaller (Quota deducted).","description":"Unlisted on Truecaller. Number found but unlisted in Truecaller (Quota deducted).","value":{"data":[{"id":"7CMQ+jHiOQtHArlX7nzdjQ==","name":"0831-1670-2362","image":null,"access":"PUBLIC","work":"","enhanced":true,"phones":[{"e164Format":"+083116702362","numberType":"MOBILE","nationalFormat":"0831-1670-2362","dialingCode":"","countryCode":"ID","carrier":"M - PT XL Axiata Tbk","type":""}],"addresses":[{"address":"Indonesia","countryCode":"ID","timeZone":"","type":"address"}],"internetAddresses":[{"id":"","service":"email","caption":"0831-1670-2362","type":"internetAddress"}],"badges":["user"],"tags":[],"cacheTtl":1296000000,"sources":[],"searchWarnings":[],"surveys":[{"id":"0905a705-3c8c-48ab-a4a6-001ce0b20566","frequency":86400,"passthroughData":"eyAiNCI6ICJwZiIsICIyMSI6ICIwIiwgIjIzIjogIjM3NzgxY2M3LTQzZWUtNDhjZS1hOWMxLWM3ZGRiODZiMGNkZSIsICIzIjogIjk3MjUwNjQ2MjM2NSIsICI4IjogIjAiLCAiMiI6ICJOb2FtIExlaWJvdml0Y2giLCAiMjIiOiAiMCIgfQ==","perNumberCooldown":31536000,"dynamicContentAccessKey":""},{"id":"4eb9afcf-f36e-430d-86f9-4f72ca091f91","frequency":86400,"passthroughData":"eyAiNCI6ICJwZiIsICIyMSI6ICIwIiwgIjIzIjogIjdkZmJlNDk4LWQ4MDUtNGIwZS1iZjM3LTUwZjhmZTliM2ZmYiIsICIzIjogIjk3MjUwNjQ2MjM2NSIsICI4IjogIjAiLCAiMiI6ICJOb2FtIExlaWJvdml0Y2giLCAiMjIiOiAiMCIgfQ==","perNumberCooldown":31536000,"dynamicContentAccessKey":""},{"id":"306103a9-9c38-4bc9-8ca7-6e9c469ba8bf","frequency":0,"passthroughData":"eyAiNCI6ICJwZiIsICIyMSI6ICIwIiwgIjIzIjogImJmOWYxYTM3LWVjMDgtNDZlMS04MWEzLWJhZDI5ZDBkOGE4ZSIsICIzIjogIjk3MjUwNjQ2MjM2NSIsICI4IjogIjAiLCAiMiI6ICJOb2FtIExlaWJvdml0Y2giLCAiMjIiOiAiMCIgfQ==","perNumberCooldown":0,"dynamicContentAccessKey":""}],"commentsStats":{"showComments":false},"manualCallerIdPrompt":false,"isFraud":false,"ns":0}],"provider":"ss-nu","stats":{"sourceStats":[]}}},"ErrorNumber":{"summary":"Result Found Error - Phone number and carrier not found (Quota not deducted).","description":"Phone number and carrier not found (Quota not deducted).","value":{"data":[{"id":"FBxnOnErRaP3EjoODR3qjg==","access":"PUBLIC","enhanced":true,"phones":[{"e164Format":"+{$phone}","numberType":"MOBILE","nationalFormat":"","dialingCode":null,"countryCode":"","carrier":"Partner","type":"openPhone"}],"addresses":[{"countryCode":"","timeZone":"","type":"address"}],"internetAddresses":[],"badges":[],"tags":[],"cacheTtl":86400000,"sources":[],"searchWarnings":[],"surveys":[{"id":"100","frequency":3600,"passthroughData":"eyAiMyI6ICI5NzI1NDYzOTczODUiLCAiOCI6ICIwIiB9","perNumberCooldown":7890000,"dynamicContentAccessKey":""},{"id":"b6588ff4-47cb-46ce-8b11-015199c1f729","frequency":3600,"passthroughData":"eyAiMyI6ICI5NzI1NDYzOTczODUiLCAiOCI6ICIwIiB9","perNumberCooldown":7890000,"dynamicContentAccessKey":""}],"commentsStats":{"showComments":false},"manualCallerIdPrompt":false,"ns":100}],"provider":"ss-nu","stats":{"sourceStats":[]}}}}}}}},"parameters":[{"name":"phone","in":"path","required":true,"schema":{"type":"string","example":"233552188188"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}