Canonical ScoreMachine API collection with workflows, method reference, troubleshooting.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"53731936","collectionId":"31558f34-b2da-419d-b7b7-a3b69e0b939e","publishedId":"2sBXionANh","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"0EB200"},"publishDate":"2026-04-05T18:13:43.000Z"},"item":[{"name":"1. Getting started","item":[{"name":"1.1 Introduction","item":[],"id":"4c39be18-5bc9-4dea-a276-d60793337f1f","description":"ScoreMachine API provides phone and email validation, phone scoring, and channel presence checks for WhatsApp, Telegram, Facebook, and Instagram.
\nTypical users include CPaaS and UCaaS vendors, SMS platforms, GTM teams, call centres, CRM operators, and systems that validate inbound leads.
\nBase URL: https://api.scoremachine.ai
Protocol: JSON-RPC 2.0 over HTTP POST
\nUse sequential methods for one phone or email at a time. Use audience and batch methods for uploaded files or larger contact lists.
\n","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"type":"text/javascript","packages":{},"requests":{},"exec":[""],"id":"1126442a-816f-4156-9eac-83c816d9434f"}},{"listen":"test","script":{"type":"text/javascript","packages":{},"requests":{},"exec":[""],"id":"1d531c1f-5044-4842-9fd5-3c1aacd46c6c"}}],"_postman_id":"4c39be18-5bc9-4dea-a276-d60793337f1f"},{"name":"1.2 Formatting and conventions","item":[],"id":"9845e39b-c3a6-48eb-9882-2444721516ce","description":"Every JSON-RPC request must include:
\njsonrpc with value 2.0
method
params
id
All examples in this collection use strict JSON formatting, unless otherwise specified in the request or expected response headers.
\nUse Token: auth_token for authenticated methods.
Use Content-Type: application/json for JSON-RPC requests.
The POST/upload and audiences.export methods returns text with Content-Type: text/plain; charset=utf-8
Phone numbers should be sent in E.164 format where possible.
\nPagination is zero-based. Use offset: 0 for the first page.
Use full channel names in documentation and examples.
\nUse sequential methods when you need an immediate answer for a single phone or email.
\nInbound lead form validation
\nPre-send checks before calling or messaging
\nCRM enrichment on a single record
\nReal-time routing decisions
\nUp to 20 requests per second
\nAround 2 seconds average response time
\nUse batch methods when you work with uploaded files or full audiences.
\nUpload a file with POST /upload
Create or select a project
\nCreate an audience and add contacts to an audience
\nEstimate price with audiences.score.price
Start processing with audiences.score.start
Poll with audiences.score.status
Export results with audiences.export
Poll no more often than every 2 seconds
\nUp to 10 concurrent jobs
\nDefault upload size limit 5 MB
\nDefault audience size limit 200,000 rows
\nThe API uses a custom HTTP header:
\nToken: {auth_token}
Use auth.register to create an account, if needed
Use auth.login to obtain an authenticated session and token
Include the Token header in all protected requests
\nIf the token expires, call auth.login again to obtain a new token
Current token TTL is 24 hours.
\n• auth.register
• auth.login
• All project, audience, scoring, export, account, billing, and transaction methods require an authentication token Token: {auth_token}, which must be included in the request header.
For a quick summary of the current authenticated account, use account.get. This method returns the current account ID, email, balance, active tariff, and pricing for supported ScoreMachine methods.
ScoreMachine distinguishes between:
\n• Payments: account top-ups
• Transactions: deductions for API usage
• Balances and pricing are returned as floating-point USD values
\n• balance.get — retrieve current balance
• payments.create — create a top-up payment
• payments.get — retrieve payment status
• payments.cancel — cancel a Stripe PaymentIntent before it is completed
• transactions.list — view usage deductions
• account.get — retrieve current tariff and pricing summary
• Call account.get to retrieve active pricing OR
• Call balance.get to retrieve the current balance
• For batch jobs, call audiences.score.price before starting the job
• Start the job only after confirming sufficient balance
• Use transactions.list to reconcile spend after processing
This method is publicly accessible without an authentication token.
\nAuthenticate a user with email and password. On success, the API returns the authorization token in the token response header.
{\n \"jsonrpc\": \"2.0\",\n \"method\": \"auth.login\",\n \"params\": {\n \"email\": \"user@example.com\",\n \"password\": \"x00Xx0x_Xx\"\n },\n \"id\": 1\n}\n\nAPI token
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"method\": \"balance.get\",\n \"params\": {},\n \"id\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://api.scoremachine.ai","description":"This method requires authentication. A valid token must be provided in the request header.
\nRetrieve the current account balance.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"balance.get\",\n \"params\": {},\n \"id\": 1\n}\n\nAPI token
\n","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"jsonrpc\": \"2.0\",\n \"method\": \"account.get\",\n \"params\": {},\n \"id\": 1\n}","options":{"raw":{"language":"json"}}},"url":"https://api.scoremachine.ai","description":"This method requires authentication. A valid token must be provided in the request header.
\nRetrieves the current account ID, email, balance, active tariff, and pricing.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"account.get\",\n \"params\": {},\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nRun sequential phone scoring. This method returns scoring results for a single phone number and run all available phone validation checks. This method does basic validation, MNP lookup and checks for online presence (Facebook, Instagram, Telegram, Whatsapp) and retrieves a contactability score.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.scoring\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nValidate email and ensure deliverability.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.email.validation\",\n \"params\": {\n \"email\": \"user_name@gmail.com\"\n },\n \"id\": 1\n}\n\nMinimal quickstart flow:
\nauth.login
balance.get or account.get
score.phone.scoring
score.email.validation
This method requires authentication. A valid token must be provided in the request header.
\nRun all available phone validation checks without scoring. This method does basic validation, MNP lookup and checks for online presence (Facebook, Instagram, Telegram, Whatsapp).
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.validation.total\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nRun basic phone validation for prefix and numbering plan check.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.validation\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nResolve the current carrier for a mobile number ported number (MNP lookup).
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.validation.mnp\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nCheck whether the phone number is associated with a Facebook account.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.validation.facebook\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nCheck whether the phone number is registered in Telegram.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.validation.telegram\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nCheck whether the phone number has a WhatsApp account.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.validation.whatsapp\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nCheck whether the phone number is associated with Instagram.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.validation.instagram\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nRun sequential phone scoring. This method returns scoring results for a single phone number and run all available phone validation checks. This method does basic validation, MNP lookup and checks for online presence (Facebook, Instagram, Telegram, Whatsapp) and retrieves a contactability score.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.scoring\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nGet only the phone accessibility (contactability) score for a single phone number without providing additional parameters.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.scoring.accessibility\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nResolve tags from a phone number.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.phone.tags\",\n \"params\": {\n \"phone\": \"+00000000001\",\n \"geo_iso_code\": \"XX\"\n },\n \"id\": 1\n}\n\nUse sequential phone methods for a single contact at a time.
\nCall score.phone.validation.total when you need all validation results without scoring.
Call individual validation methods when you only need one specific service.
\nCall score.phone.scoring.accessibility when you only need the accessibility or contactability score.
This method requires authentication. A valid token must be provided in the request header.
\nValidate email and ensure deliverability.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.email.validation\",\n \"params\": {\n \"email\": \"user_name@gmail.com\"\n },\n \"id\": 1\n}\n\nThis method requires authentication. A valid token must be provided in the request header.
\nResolve tags from an email address.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"score.email.tags\",\n \"params\": {\n \"email\": \"user_name@gmail.com\"\n },\n \"id\": 1\n}\n\nCurrent sequential email methods cover validation and tags.
Use these methods for inbound forms, CRM cleanup on a single record, or lightweight enrichment.
This method requires authentication. A valid token must be provided in the request header.
\nCreate a new project. Projects group multiple audiences for one customer, campaign, source, or use case.
\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"projects.create\",\n \"params\": {\n \"name\": \"Project Name\",\n \"description\": \"Project Description\"\n },\n \"id\": 1\n}\n\n