---
title: "Query your resource"
method: POST
path: "/{service}-rep/service/v2.0/query"
tags: ["Query"]
---

# Query your resource

`POST /{service}-rep/service/v2.0/query`

## Path parameters

- `service` 'url' | 'ip' | 'file', required

## Query parameters

- `resource` string, required

## Headers

- `Client-Key` string, uuid, required
- `token` string, required

## Request body

- ReputationRequest
  - `request` ReputationSingleRequest[], required
    - `resource` string

## Response `200`

OK

- ReputationResponse
  - `risk` number
  - `resource` string
  - `reputation` ReputationClassification
    - `classification` string
    - `severity` 'N/A' | 'Low' | 'Medium' | 'High' | 'Critical'
    - `Confidence` 'Low' | 'Medium' | 'High'
  - `status` ReputationStatus
    - `code` 2001 | 2002
    - `label` 'SUCCESS' | 'PARTIAL_SUCCESS'
    - `message` 'Succeeded to generate reputation' | 'Some vendors are unavailable'
  - `context` ReputationResponseContext
    - `asn` number — ASN of the IP (IP)
    - `as_owner` string — ASN owner of the IP (IP)
    - `safe` boolean — exists and true if certified safe (URL)
    - `malware_family` string — the malware family associated with the resource (URL/FILE/IP)
    - `protection_name` string — The protection name returned from Malware Service / AntiVirus (URL/FILE)
    - `redirections` string[] — The redirections of the resource (URL)
    - `malware_types` string[] — The malware types based on VT scans (FILE)
    - `categories` string[] — URLF categories (URL)
    - `location` object — geo location information (IP)
      - `region` string
      - `city` string
      - `postalCode` string
      - `latitude` number
      - `longitude` number
      - `dma_code` integer
      - `area_code` integer
      - `metro_code` integer
    - `related_resources` object — (FILE)
      - `similar_files_found` number — How many similar files found
      - `similar_files_details` object — Information about the similar file
        - `md5` string
        - `ssdeep` string
        - `ssdeep_similarity` string
        - `file_type` string
        - `classification` string
        - `malware_family` string
        - `confidence` string

## Other responses

- `400` — Bad Request - Check the request paremters
- `401` — Invalid Client-Key header
- `403` — Invalid token header
- `404` — The requested URL was not found
- `429` — Quota exceeded

## Changes

- **2025-07-13** `41903bb4a530` — 2 warning
  - removed the optional property `context/alexa_rank` from the response with the `200` status
  - removed the optional property `context/vt_categories` from the response with the `200` status
- **2025-05-22** `5c64fc7f08eb` — 2 warning, 6 info
  - removed the optional property `context/google_safe_browsing_categories` from the response with the `200` status
  - removed the optional property `context/phishing` from the response with the `200` status
  - added the non-success response with the status `404`
  - added the optional property `context/alexa_rank` to the response with the `200` status
  - …4 more
- **2020-10-15** `cf05866fe176` — 1 info
  - added the non-success response with the status `429`
- **2020-02-11** `3c805274ad67` — 3 warning, 4 info
  - added the new `2003.00` enum value to the `status/code` response property for the response status `200`
  - added the new `FAILED` enum value to the `status/label` response property for the response status `200`
  - added the new `Failed to process` enum value to the `status/message` response property for the response status `200`
  - removed the non-success response with the status `404`
  - …3 more

[Change history](https://skmtc.dev/checkpointsw/apis/check-point-reputation-service-api/changes/:service-rep/service/v2.0/query/post.md)

---

[API](https://skmtc.dev/checkpointsw/apis/check-point-reputation-service-api.md) · [All operations](https://skmtc.dev/checkpointsw/apis/check-point-reputation-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkpointsw/apis/check-point-reputation-service-api/revisions/514f5a00b235?raw)