---
title: HTTP quickstart | Lightfield
description: Get started with the Lightfield API using HTTP.
---

The Lightfield API is currently in beta. Methods, parameters, and response schemas may change as we incorporate feedback during this period.

This guide walks you through making your first request to the Lightfield API using HTTP and curl.

## Get an API key

An [API key](/using-the-api/api-keys/index.md) can be created in [Lightfield settings](https://crm.lightfield.app/crm/settings/api-keys) (admin only).

When creating the key, select the [scopes](/using-the-api/scopes/index.md) your integration needs.

For the test call just below, you’ll need `accounts:read`.

## Make your first request

[List](/api/resources/account/methods/list/index.md) one account to verify your key and scope:

Terminal window

```
curl "https://api.lightfield.app/v1/accounts?limit=1" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Lightfield-Version: 2026-03-01"
```

Replace `YOUR_API_KEY` with your key (`sk_lf_...`). With `limit=1`, you will get at most one account back. The response is JSON. A successful response will look like:

```
{
  "data": [
    {
      "id": "id",
      "createdAt": "createdAt",
      "fields": {
        "foo": {
          "value": "string",
          "valueType": "valueType"
        }
      },
      "httpLink": "httpLink",
      "relationships": {
        "foo": {
          "cardinality": "cardinality",
          "objectType": "objectType",
          "values": [
            "string"
          ]
        }
      }
    }
  ],
  "object": "object",
  "totalCount": 1
}
```

To fetch more results, use the `limit` and `offset` query parameters. See [List methods](/using-the-api/list-endpoints/index.md) to learn how to handle paginated requests.

If you get `401 Unauthorized`, check that the key is correct and in the `Authorization: Bearer ...` header. If you get `403 Forbidden`, your key may not have the required scope (e.g. `accounts:read` for listing accounts). For more on error responses and how to handle them, see [Errors](/using-the-api/errors/index.md).

## Next steps

- **[Objects in Lightfield](/objects-in-lightfield/object-types/index.md)** — Overview of object types (accounts, contacts, opportunities, and more) and how they relate.
- **[API Reference](/api/index.md)** — Full list of operations, request parameters, and response schemas.
- **[Rate limits](/using-the-api/rate-limits/index.md)** — Request limits and how to handle 429 responses.
- **[Idempotency](/using-the-api/idempotency/index.md)** — Safe retries for create and update operations.