Skip to main content
GET
/
service
/
v2
/
file-search
/
{job_id}
Get File Search Job Status
curl --request GET \
  --url https://oathnet.org/api/service/v2/file-search/{job_id} \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "message": "<string>",
  "data": {
    "job_id": "<string>",
    "status": "queued",
    "created_at": "2023-11-07T05:31:56Z",
    "started_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z",
    "expires_at": "2023-11-07T05:31:56Z",
    "next_poll_after_ms": 123,
    "limits": {
      "byte_budget_bytes": 123,
      "job_ttl_seconds": 123,
      "max_context_lines": 123,
      "max_expression_length": 123,
      "max_file_size_bytes": 123,
      "max_log_ids": 123,
      "max_matches": 123
    },
    "summary": {
      "files_scanned": 123,
      "files_total": 123,
      "files_matched": 123,
      "matches": 123,
      "bytes_scanned": 123,
      "duration_ms": 123,
      "budget_exceeded": true,
      "truncated": true,
      "timeouts": 123
    },
    "matches": [
      {
        "log_id": "<string>",
        "file_id": "<string>",
        "file_name": "<string>",
        "relative_path": "<string>",
        "size_bytes": 123,
        "match_text": "<string>",
        "line_number": 123,
        "column_range": {
          "start": 123,
          "end": 123
        },
        "snippet": {
          "line": "<string>",
          "pre": [
            "<string>"
          ],
          "post": [
            "<string>"
          ],
          "truncated": true
        }
      }
    ],
    "progress": {},
    "_meta": {
      "user": {
        "plan": "Pro",
        "plan_type": "pro",
        "is_plan_active": true
      },
      "lookups": {
        "used_today": 5,
        "left_today": 995,
        "daily_limit": 1000,
        "is_unlimited": false
      },
      "service": {
        "name": "Service Name",
        "id": "service-id",
        "category": "general",
        "is_premium": false,
        "is_available": true,
        "session_quota": 10
      },
      "performance": {
        "duration_ms": 111.47,
        "timestamp": "2026-01-06T00:44:08.191547"
      }
    }
  }
}

Authorizations

x-api-key
string
header
required

API key for authentication (lowercase header name)

Path Parameters

job_id
string
required

Response

Job status and results

success
boolean
message
string
data
object