Get SOCKS Check Results

Retrieve SOCKS/IP checker tasks and reports.

Get All SOCKS Checks

Endpoint

GET /api/v1/checkers/socks/

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number
page_size	integer	No	Results per page

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/checkers/socks/?page=1&page_size=20' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response (200)

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "f2d03f0d-22f7-4af9-a7fd-1f554faa10de",
      "status": "completed",
      "created_at": "2026-03-07T12:00:00Z",
      "report": "IP reputation report payload"
    }
  ]
}

Get Specific SOCKS Check

Endpoint

GET /api/v1/checkers/socks/{id}/

Path Parameters

Parameter	Type	Required	Description
id	string (uuid)	Yes	Check identifier

Request

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/checkers/socks/f2d03f0d-22f7-4af9-a7fd-1f554faa10de/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Response (200)

{
  "id": "f2d03f0d-22f7-4af9-a7fd-1f554faa10de",
  "status": "completed",
  "created_at": "2026-03-07T12:00:00Z",
  "report": "IP reputation report payload"
}

Response Fields

Field	Type	Description
id	string (uuid)	Checker task identifier
status	string	Task status
created_at	string (date-time)	Creation timestamp
report	string	Report payload

Status Values

Value	Description
new	Just created. Not yet processed
ready_to_perform_audit	Ready to run audit
processing	Waiting report
completed	Finished (success or failed, details in report)