Search Loop Links

Search existing Loop Links.

Search Loop Links

get

Authorizations

BearerAuth

AuthorizationstringRequired

Enter your PredictHQ API key. The Bearer prefix is added automatically.

When calling the API directly, send: 'Authorization: Bearer <YOUR_API_KEY>' as documented at https://docs.predicthq.com/api/overview/authenticating

Query parameters

offsetintegerOptional

Offset the results.

Default: 0

limitintegerOptional

Limit the number of results.

Default: 10

qstring · min: 1 · max: 120Optional

Full-text search.

E.g. ?q=hotel+a

Pattern: ^[a-zA-Z0-9 _-]+$

link_idstring[]Optional

A comma-separated list of Loop Link IDs

user_idstring[]Optional

A comma-separated list of user IDs

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/v1/loop/links

HTTPcURLJavaScriptPython

GET /v1/loop/links HTTP/1.1
Host: api.predicthq.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "next": "https://example.com",
  "previous": "https://example.com",
  "links": [
    {
      "link_id": "text",
      "expire_dt": "2025-12-13T00:55:25.179Z",
      "metadata": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "name": "text",
      "status": "text",
      "create_dt": "2025-12-13T00:55:25.179Z",
      "update_dt": "2025-12-13T00:55:25.179Z",
      "links": {
        "event": "https://example.com",
        "event_feedback": "https://example.com"
      }
    }
  ]
}

Examples

curl

curl -X GET "https://api.predicthq.com/v1/loop/links?sort=name" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN"

python

OpenAPI Spec

The OpenAPI spec for Loop API can be found here.

Guides

ow are some guides relevant to this API:

• Integrate with Loop Links