# Spam score + HLR ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/lookup/{phone}: get: summary: Spam score + HLR deprecated: false description: >- This endpoint allows you to see the phone number status and entity type (owner) tags: - Spam protection parameters: - name: phone in: path description: Phone number to lookup required: true example: 18883578668 schema: type: integer - name: hlr in: query description: Perform HLR lookup required: false example: 'false' schema: type: boolean responses: '200': description: '' content: application/json: schema: type: object properties: data: type: object required: - business_info - carrier_info - complaints - entity_type - is_spam - phone - reputation - spam_score - total_complaints properties: business_info: &ref_0 $ref: '#/components/schemas/Business%20info' carrier_info: &ref_1 $ref: '#/components/schemas/Carrier%20info' complaints: type: array items: &ref_2 $ref: '#/components/schemas/Complaint%20(without%20number)' entity_type: type: string description: Entity type (e.g., BUSINESS, SPAM, UNKNOWN) enum: - BUSINESS - SPAM - UNKNOWN x-apidog-enum: - value: BUSINESS name: '' description: '' - value: SPAM name: '' description: '' - value: UNKNOWN name: '' description: '' is_spam: type: boolean description: Whether this phone number is marked as spam phone: type: string description: Phone number in E.164 format reputation: type: string description: Reputation label for the number spam_score: type: integer description: Spam score 0–100 total_complaints: type: integer description: Total number of complaints recorded x-apidog-orders: - business_info - carrier_info - complaints - entity_type - is_spam - phone - reputation - spam_score - total_complaints x-apidog-ignore-properties: [] status: type: string description: Request status enum: - success - error x-apidog-orders: - 01K1ZZHHZDKDVNN9PZT1QCM4QQ required: - data - status x-apidog-refs: 01K1ZZHHZDKDVNN9PZT1QCM4QQ: $ref: '#/components/schemas/Spam%20score%20request' x-apidog-ignore-properties: - data - status examples: '1': summary: Verified business entity value: data: business_info: business_name: CallerAPI LC category: services city: Casper country: US industry: Computer Security-Systems & Services state: WY verified: true complaints: null entity_type: BUSINESS is_spam: false phone: '+18883578668' reputation: VERIFIED spam_score: 0 total_complaints: 0 status: success '2': summary: Personal phone number value: data: business_info: null complaints: null entity_type: UNKNOWN is_spam: false phone: '+17862455272' reputation: UNKNOWN spam_score: 0 total_complaints: 0 status: success '3': summary: Spam number value: data: business_info: null complaints: - CreatedDate: '2025-08-01T16:46:22Z' ViolationDate: '2025-07-30T18:23:00Z' ConsumerState: Florida Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2025-07-13T14:00:13Z' ViolationDate: '2025-07-07T12:57:00Z' ConsumerState: Michigan Subject: Dropped call or no message RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2025-07-13T14:00:13Z' ViolationDate: '2025-07-07T12:57:00Z' ConsumerState: Michigan Subject: Dropped call or no message RecordedMessageOrRobocall: 'N' Comment: '' entity_type: UNKNOWN is_spam: true phone: '+16606681060' reputation: SPAM spam_score: 30 total_complaints: 3 status: success '4': summary: Medium-risk business number value: data: business_info: business_name: Google category: services city: Mountain View country: US industry: Internet Services state: CA verified: true complaints: - CreatedDate: '2025-08-03T21:06:31Z' ViolationDate: '2025-08-03T21:04:00Z' ConsumerState: New York Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-08-04T19:47:55Z' ViolationDate: '2025-08-03T15:15:00Z' ConsumerState: Texas Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2025-08-04T19:47:55Z' ViolationDate: '2025-08-03T15:15:00Z' ConsumerState: Texas Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2025-07-28T22:26:54Z' ViolationDate: '2025-07-28T22:11:00Z' ConsumerState: Ohio Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2025-07-29T02:07:36Z' ViolationDate: '2025-07-28T15:08:00Z' ConsumerState: Missouri Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-07-22T22:28:56Z' ViolationDate: '2025-07-22T08:20:00Z' ConsumerState: Montana Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-07-22T22:28:56Z' ViolationDate: '2025-07-22T08:20:00Z' ConsumerState: Montana Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-07-20T04:26:21Z' ViolationDate: '2025-07-19T17:30:00Z' ConsumerState: Oregon Subject: Computer & technical support RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2025-07-13T01:16:23Z' ViolationDate: '2025-07-12T23:28:00Z' ConsumerState: Wisconsin Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-07-13T01:16:23Z' ViolationDate: '2025-07-12T23:28:00Z' ConsumerState: Wisconsin Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-03-17T09:18:11Z' ViolationDate: '2025-03-06T12:00:00Z' ConsumerState: Georgia Subject: >- Reducing your debt (credit cards, mortgage, student loans) RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-02-10T16:05:06Z' ViolationDate: '2025-02-11T01:59:00Z' ConsumerState: California Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2025-02-05T13:00:16Z' ViolationDate: '2025-02-05T09:54:00Z' ConsumerState: Kansas Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-02-04T14:39:02Z' ViolationDate: '2025-02-04T11:37:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-01-17T15:24:24Z' ViolationDate: '2025-01-17T12:23:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2025-01-09T14:49:55Z' ViolationDate: '2025-01-09T11:49:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-12-16T12:16:37Z' ViolationDate: '2024-12-16T09:15:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-12-06T14:14:48Z' ViolationDate: '2024-12-06T13:10:00Z' ConsumerState: Ohio Subject: Dropped call or no message RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-11-17T09:58:13Z' ViolationDate: '2024-11-16T18:53:00Z' ConsumerState: Michigan Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-11-13T14:36:15Z' ViolationDate: '2024-11-13T13:09:00Z' ConsumerState: Connecticut Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-11-01T14:17:48Z' ViolationDate: '2024-11-01T11:16:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-10-23T09:38:07Z' ViolationDate: '2024-10-23T09:37:00Z' ConsumerState: Florida Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-10-23T09:45:02Z' ViolationDate: '2024-10-23T09:34:00Z' ConsumerState: Florida Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-10-23T09:44:01Z' ViolationDate: '2024-10-23T09:33:00Z' ConsumerState: Florida Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-10-14T16:19:54Z' ViolationDate: '2024-10-14T15:14:00Z' ConsumerState: Minnesota Subject: Computer & technical support RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-10-14T12:57:15Z' ViolationDate: '2024-10-14T11:00:00Z' ConsumerState: Tennessee Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-10-10T16:06:27Z' ViolationDate: '2024-10-10T09:15:00Z' ConsumerState: Kansas Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-08-21T15:13:16Z' ViolationDate: '2024-08-21T10:00:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-07-01T12:56:58Z' ViolationDate: '2024-07-01T09:55:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T18:16:09Z' ViolationDate: '2024-06-19T12:26:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T22:22:10Z' ViolationDate: '2024-06-19T12:26:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T18:26:11Z' ViolationDate: '2024-06-19T12:00:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T16:27:32Z' ViolationDate: '2024-06-19T12:00:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T16:36:37Z' ViolationDate: '2024-06-19T12:00:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T16:56:20Z' ViolationDate: '2024-06-19T12:00:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T17:07:08Z' ViolationDate: '2024-06-19T12:00:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-19T17:16:11Z' ViolationDate: '2024-06-19T12:00:00Z' ConsumerState: Utah Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-10T11:30:49Z' ViolationDate: '2024-06-10T08:28:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-06-03T11:59:32Z' ViolationDate: '2024-06-03T08:58:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-05-06T03:49:25Z' ViolationDate: '2024-05-06T12:00:00Z' ConsumerState: Ohio Subject: Dropped call or no message RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-04-25T22:22:14Z' ViolationDate: '2024-04-25T12:00:00Z' ConsumerState: Illinois Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-04-24T11:49:40Z' ViolationDate: '2024-04-24T08:48:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-02-26T11:24:05Z' ViolationDate: '2024-02-26T08:12:00Z' ConsumerState: California Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-02-21T14:54:15Z' ViolationDate: '2024-02-21T14:36:00Z' ConsumerState: New York Subject: Computer & technical support RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2024-02-13T11:36:53Z' ViolationDate: '2024-02-13T08:35:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2024-01-10T17:43:19Z' ViolationDate: '2024-01-10T17:40:00Z' ConsumerState: Massachusetts Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2023-12-22T12:04:02Z' ViolationDate: '2023-12-22T09:03:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-12-22T12:04:02Z' ViolationDate: '2023-12-22T09:03:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-11-20T12:37:31Z' ViolationDate: '2023-11-20T09:36:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-10-28T23:39:45Z' ViolationDate: '2023-10-28T19:52:00Z' ConsumerState: California Subject: >- Calls pretending to be government, businesses, or family and friends RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2023-10-12T11:45:17Z' ViolationDate: '2023-10-12T08:43:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-09-06T14:16:45Z' ViolationDate: '2023-09-06T11:15:00Z' ConsumerState: California Subject: Computer & technical support RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-07-24T15:01:17Z' ViolationDate: '2023-07-24T12:00:00Z' ConsumerState: California Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-07-24T11:09:35Z' ViolationDate: '2023-07-24T09:00:00Z' ConsumerState: New Jersey Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-06-06T13:42:11Z' ViolationDate: '2023-06-06T10:41:00Z' ConsumerState: California Subject: Work from home & other ways to make money RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2023-03-20T14:36:34Z' ViolationDate: '2023-03-20T11:35:00Z' ConsumerState: California Subject: Work from home & other ways to make money RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2022-11-22T12:25:29Z' ViolationDate: '2022-11-22T11:23:00Z' ConsumerState: Illinois Subject: Other RecordedMessageOrRobocall: 'Y' Comment: '' - CreatedDate: '2022-10-13T16:17:07Z' ViolationDate: '2022-10-13T15:52:00Z' ConsumerState: Georgia Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2022-09-21T23:39:43Z' ViolationDate: '2022-09-18T12:50:00Z' ConsumerState: Colorado Subject: Other RecordedMessageOrRobocall: 'N' Comment: '' - CreatedDate: '2020-09-01T00:00:00Z' ViolationDate: '2020-09-02T00:00:00Z' ConsumerState: NS Subject: Tech Support RecordedMessageOrRobocall: '' Comment: '' entity_type: BUSINESS is_spam: true phone: '+16502530000' reputation: SPAM spam_score: 100 total_complaints: 60 status: success '5': summary: HLR lookup value: data: business_info: null carrier_info: country: code: '1' iso: US name: United States network: carrier: Centurylink ocn: '4802' original: carrier: T-Mobile spid: '8824' spid: '8824' type: CLEC number: landline: true local_format: '17862455272' lrn: '17862506199' mobile: false msisdn: '17862455272' ported: true ported_date: '2006-06-30T02:11:00Z' type: CLEC valid: 'true' complaints: null entity_type: UNKNOWN is_spam: false phone: '+17862455272' reputation: UNKNOWN spam_score: 0 total_complaints: 0 status: success headers: {} x-apidog-name: OK '401': description: '' content: application/json: schema: type: object properties: error: type: string required: - error x-apidog-orders: - error x-apidog-ignore-properties: [] example: error: Missing API key headers: {} x-apidog-name: Unauthorized security: - CallerAPI Key: [] x-apidog: schemeGroups: - id: 7Wgpz7XqJ5wdLyzsKr91e schemeIds: - CallerAPI Key required: true use: id: 7Wgpz7XqJ5wdLyzsKr91e x-apidog-folder: Spam protection x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1027392/apis/api-19887237-run components: schemas: Complaint (without number): required: - CreatedDate - ViolationDate - ConsumerState - Subject - RecordedMessageOrRobocall - Comment type: object properties: CreatedDate: type: string format: date-time description: Timestamp when complaint was created (UTC) ViolationDate: type: string format: date-time description: Timestamp when violation occurred (UTC) ConsumerState: type: string description: U.S. state of the consumer filing the complaint Subject: type: string description: Issue category reported enum: - Advance Fee Loan - Bank/Credit Card Company Imposter - Business Email Compromise - >- Calls pretending to be government, businesses, or family and friends - Charity - Computer & Technical Support - Counterfeit Product - COVID-19 - Credit Cards - Credit Repair/Debt Relief - Cryptocurrency - Debt Collection - Lotteries, Prizes & Sweepstakes - Medical & Prescriptions - Moving - No Subject Provided - Phishing - Reducing Your Debt (Credit Cards, Mortgage, Student Loans) - Rental - Romance - Tax Collection - Travel/Vacation/Timeshare - Utility - Warranties & Protection Plans - Work From Home & Other Ways To Make Money - Yellow Pages/Directories - Hang Up - Scammers - Advertising - Surveys - Financial Services - Store - Company - Other x-apidog-enum: - value: Advance Fee Loan name: '' description: '' - value: Bank/Credit Card Company Imposter name: '' description: '' - value: Business Email Compromise name: '' description: '' - value: >- Calls pretending to be government, businesses, or family and friends name: '' description: '' - value: Charity name: '' description: '' - value: Computer & Technical Support name: '' description: '' - value: Counterfeit Product name: '' description: '' - value: COVID-19 name: '' description: '' - value: Credit Cards name: '' description: '' - value: Credit Repair/Debt Relief name: '' description: '' - value: Cryptocurrency name: '' description: '' - value: Debt Collection name: '' description: '' - value: Lotteries, Prizes & Sweepstakes name: '' description: '' - value: Medical & Prescriptions name: '' description: '' - value: Moving name: '' description: '' - value: No Subject Provided name: '' description: '' - value: Phishing name: '' description: '' - value: Reducing Your Debt (Credit Cards, Mortgage, Student Loans) name: '' description: '' - value: Rental name: '' description: '' - value: Romance name: '' description: '' - value: Tax Collection name: '' description: '' - value: Travel/Vacation/Timeshare name: '' description: '' - value: Utility name: '' description: '' - value: Warranties & Protection Plans name: '' description: '' - value: Work From Home & Other Ways To Make Money name: '' description: '' - value: Yellow Pages/Directories name: '' description: '' - value: Hang Up name: '' description: '' - value: Scammers name: '' description: '' - value: Advertising name: '' description: '' - value: Surveys name: '' description: '' - value: Financial Services name: '' description: '' - value: Store name: '' description: '' - value: Company name: '' description: '' - value: Other name: '' description: '' RecordedMessageOrRobocall: type: string enum: - 'Y' - 'N' - '' description: Whether a recorded message or robocall was received Comment: type: string description: Reporter comment x-apidog-orders: - CreatedDate - ViolationDate - ConsumerState - Subject - RecordedMessageOrRobocall - Comment x-apidog-ignore-properties: [] x-apidog-folder: '' Carrier info: type: object properties: country: type: object properties: code: type: string description: Country code iso: type: string description: Country ISO name: type: string description: Country name required: - code - iso - name x-apidog-orders: - code - iso - name x-apidog-ignore-properties: [] network: type: object properties: carrier: type: string description: Current carrier (operator) name ocn: type: string description: Operating Company Number original: type: object properties: carrier: type: string description: Original (previous) carrier spid: type: string description: Original (previous) Service Provider ID required: - carrier - spid x-apidog-orders: - carrier - spid x-apidog-ignore-properties: [] spid: type: string description: Service Provider ID type: type: string description: Number type enum: - CAP - CLEC - GENERAL - IC - ILEC - INTL - IPES - L RESELLER - PCS - RBOC - ULEC - WIRELESS - W RESELLER x-apidog-enum: - value: CAP name: Competitive Access Provider description: '' - value: CLEC name: Competitive Local Exchange Carrier description: '' - value: GENERAL name: General Use description: '' - value: IC name: Interexchange Carrier description: '' - value: ILEC name: Incumbent Local Exchange Carrier description: '' - value: INTL name: International Carrier description: '' - value: IPES name: IP-Enabled Services Provider description: '' - value: L RESELLER name: Local Reseller description: '' - value: PCS name: Personal Communications Service description: '' - value: RBOC name: Regional Bell Operating Company description: '' - value: ULEC name: Unbundled Local Exchange Carrier description: '' - value: WIRELESS name: Wireless Carrier description: '' - value: W RESELLER name: Wireless Reseller description: '' required: - carrier - ocn - original - spid - type x-apidog-orders: - carrier - ocn - original - spid - type x-apidog-ignore-properties: [] number: type: object properties: landline: type: boolean description: Is phone number landline local_format: type: string description: Phone number in local format lrn: type: string description: Local Routing Number mobile: type: boolean description: Is phone number a mobile msisdn: type: string description: Mobile Station International Subscriber Directory Number ported: type: boolean description: Is number ported ported_date: type: string description: Ported date type: type: string description: Number type enum: - CAP - CLEC - GENERAL - IC - ILEC - INTL - IPES - L RESELLER - PCS - RBOC - ULEC - WIRELESS - W RESELLER x-apidog-enum: - value: CAP name: Competitive Access Provider description: '' - value: CLEC name: Competitive Local Exchange Carrier description: '' - value: GENERAL name: General Use description: '' - value: IC name: Interexchange Carrier description: '' - value: ILEC name: Incumbent Local Exchange Carrier description: '' - value: INTL name: International Carrier description: '' - value: IPES name: IP-Enabled Services Provider description: '' - value: L RESELLER name: Local Reseller description: '' - value: PCS name: Personal Communications Service description: '' - value: RBOC name: Regional Bell Operating Company description: '' - value: ULEC name: Unbundled Local Exchange Carrier description: '' - value: WIRELESS name: Wireless Carrier description: '' - value: W RESELLER name: Wireless Reseller description: '' valid: type: string description: Is phone number valid required: - landline - local_format - lrn - mobile - msisdn - ported - ported_date - type - valid x-apidog-orders: - landline - local_format - lrn - mobile - msisdn - ported - ported_date - type - valid x-apidog-ignore-properties: [] required: - country - network - number x-apidog-orders: - country - network - number x-apidog-ignore-properties: [] x-apidog-folder: '' Business info: required: - business_name - category - city - state - country - industry - verified type: object properties: business_name: type: string description: The registered name of the business category: type: string description: High-level category of the business city: type: string description: City where the business is located state: type: string description: State or province country: type: string description: Country code (e.g., US) industry: type: string description: Specific industry sector verified: type: boolean description: Whether the business has been verified x-apidog-orders: - business_name - category - city - state - country - industry - verified x-apidog-ignore-properties: [] x-apidog-folder: '' Spam score request: required: - data - status type: object properties: data: type: object required: - business_info - carrier_info - complaints - entity_type - is_spam - phone - reputation - spam_score - total_complaints properties: business_info: *ref_0 carrier_info: *ref_1 complaints: type: array items: *ref_2 entity_type: type: string description: Entity type (e.g., BUSINESS, SPAM, UNKNOWN) enum: - BUSINESS - SPAM - UNKNOWN x-apidog-enum: - value: BUSINESS name: '' description: '' - value: SPAM name: '' description: '' - value: UNKNOWN name: '' description: '' is_spam: type: boolean description: Whether this phone number is marked as spam phone: type: string description: Phone number in E.164 format reputation: type: string description: Reputation label for the number spam_score: type: integer description: Spam score 0–100 total_complaints: type: integer description: Total number of complaints recorded x-apidog-orders: - business_info - carrier_info - complaints - entity_type - is_spam - phone - reputation - spam_score - total_complaints x-apidog-ignore-properties: [] status: type: string description: Request status enum: - success - error x-apidog-orders: - data - status x-apidog-ignore-properties: [] x-apidog-folder: '' securitySchemes: CallerAPI Key: type: apikey in: header name: x-auth ApiKeyAuth: type: apikey in: header name: X-Auth description: CallerAPI API key (UUID). servers: - url: https://api.callerapi.com description: Prod Env security: - CallerAPI Key: [] x-apidog: schemeGroups: - id: 7Wgpz7XqJ5wdLyzsKr91e schemeIds: - CallerAPI Key required: true use: id: 7Wgpz7XqJ5wdLyzsKr91e ```