Skip to main content
GET
/
farcaster
/
following
/
status
Get Farcaster Following Status
curl --request GET \
  --url https://api.memoryproto.co/farcaster/following/status \
  --header 'Authorization: Bearer <token>'
{
  "status": "in_progress",
  "progress": {
    "current": 1245,
    "total": 3632
  },
  "timestamp": "2025-05-09T19:51:32.016Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Authorization
string
required

Get your API key at https://memoryproto.co/developers.

Example:

"Bearer mem_xxx"

Query Parameters

​
username
string

Farcaster username of the user. For example, memoryprotocol.eth or base.base.eth.

Examples:

"memoryprotocol.eth"

"base.base.eth"

​
fid
number | null

Fid of the Farcaster account. For example, 244819 or 12142.

Examples:

244819

12142

Response

Successful response containing the following indexing status.

​
status
required

Account follows fetch status: queued when the request is queued, in_progress while data is being fetched and partial results are available, andcompleted once all follows have been retrieved and are available.

Available options:
in_progress
Example:

"in_progress"

​
progress
object
required
Example:
{ "current": 1245, "total": 3632 }
​
timestamp
string | null
required

Timestamp of when the data was fetched, only available when the status is completed.

Example:

"2025-05-09T19:51:32.016Z"