Skip to main content
POST
/
astp
/
v2
/
cookies
/
_search
Search Cookies
curl --request POST \
  --url https://api.flare.io/astp/v2/cookies/_search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "domain": "<string>",
  "values": [
    "<string>"
  ],
  "size": 123,
  "from": "<string>",
  "names": [
    "<string>"
  ],
  "paths": [
    "<string>"
  ],
  "imported_after": "<string>",
  "expires_after": "<string>",
  "order": "<string>"
}'
{
        "items": [
            {
                "uuid": "44672461-aca4-4b3b-b192-6bd5429c4c6d",
                "domain": "scatterholt.com",
                "expires_at": "2024-10-18T00:00:00+00:00",
                "imported_at": "2024-01-01T00:00:00+00:00",
                "name": "session",
                "path": "/",
                "event_uid": "stealer_log/stealer_logs_live/12345",
                "value": "abcdefghijkl",
            },
        ],
        "next": "WzFd",
    }
}
This endpoint requires access to Account & Session Takeover Prevention (ASTP). Please contact your Customer Success Manager for more details.
Returns a list of cookies matching the query provided. 
{
        "items": [
            {
                "uuid": "44672461-aca4-4b3b-b192-6bd5429c4c6d",
                "domain": "scatterholt.com",
                "expires_at": "2024-10-18T00:00:00+00:00",
                "imported_at": "2024-01-01T00:00:00+00:00",
                "name": "session",
                "path": "/",
                "event_uid": "stealer_log/stealer_logs_live/12345",
                "value": "abcdefghijkl",
            },
        ],
        "next": "WzFd",
    }
}

​
Paging

This endpoint supports the Flare standard paging pattern .

​
Guides

See the guide for using this endpoint: Monitor Leaked Cookies for your Domain .

​
Body Parameters

​
domain
string
The exact domain for which you want to search cookies. Subdomains will not be included.
​
values
string[]
A list of exact values for which you want to search cookies. Currently limited to a single value.
​
size
number
The number of results to fetch. (default: 100, max: 2000)
​
from
string
The next value from the last response.
​
names
string[]
A list of names to filter for specific cookies, for example ['session', 'PHPSESSID']. (max: 10)
​
paths
string[]
A list of paths to filter for specific cookies, for example ['/', '/login']. (max: 10)
​
imported_after
string
ISO-formatted datetime string to filter for cookies added to Flare’s database after a given date, for example 2024-10-29T17:50:44.237148+00:00.
​
expires_after
string
ISO-formatted datetime string to filter for cookie expiration, for example 2024-10-29T17:50:44.237148+00:00.
​
order
string
Order in which you want to browse the cookies. One of asc or desc. It defaults to asc which is the recommended way to use the API to obtain newly imported cookies.