# API v1 Reference - Grep

[Developers](/developers)[API Reference](/developers/api)API v1 (deprecated)

# Grep API v1 — Deprecated

The v1 API is the original Grep public surface. Existing integrations continue to work; new integrations should use v2.

This API version is deprecated

New integrations should target /api/v2 — same primitives, plus idempotency keys, cursor pagination, structured error envelopes, and credit headers. See<!-- --> [API v2 Reference →](/developers/api/v2)

## Migrate new work to v2

This page intentionally does not render v1 snippets. Use the v2 reference and quickstart for current request and response shapes.

### Use the research resource

Create jobs with POST /api/v2/research and poll GET /api/v2/research/{job\_id\_or\_slug}. v2 also exposes timeline, files, quota, and billing endpoints.

### Send effort

Use effort: low, medium, high, or build. Older compatibility aliases should not be used in new integrations.

### Read the report envelope

Use report.markdown, structured\_output, revisions, files, and timeline.items. Avoid legacy result parsing and status: complete as the primary shape.

### Handle structured errors

Expect { error: { code, message, details, request\_id } } and use X-Request-ID plus X-Grep-\* correlation headers when debugging.

[Open API v2 Reference](/developers/api/v2)[Read Quickstart](/developers/api/quickstart)