[Docs](https://linkinseconds.com/docs)Developers

# List your links

GET /api/v1/links returns your links, newest first, with their URLs and status.

GET`/api/v1/links`API key required

Returns the links on your account, newest first. Useful to find a link you published earlier or check its status.

Query parameters

`limit`integer

How many links to return, 1 to 100. Default `20`.

```
curl "https://linkinseconds.com/api/v1/links?limit=5" \
  -H "Authorization: Bearer $LIS_API_KEY"
```

200 OK

```
{
  "links": [
    {
      "slug": "report-x7",
      "title": "report",
      "url": "https://lisview.com/report-x7",
      "kind": "pdf",
      "size_bytes": 482113,
      "created_at": "2026-10-04T09:12:44.120Z",
      "status": "live"
    }
  ]
}
```

## Status values

| status | Meaning |

| `live` | Anyone with the link can open it. |

| `review` | Held by the safety scan until a person checks it. Not public yet. |

| `processing` | A video still being scanned. Goes live shortly. |

| `disabled` | You switched the link off in its settings. |

Album and website links are not included. To change a link's settings or delete it, use the [dashboard](https://linkinseconds.com/dashboard).

[PreviousUpload a file](https://linkinseconds.com/docs/api/uploads)[Next Analytics](https://linkinseconds.com/docs/api/analytics)

Last updated 4 October 2026. Something unclear or missing? [Tell us](https://linkinseconds.com/contact).

Source: https://linkinseconds.com/docs/api/links