Skip to main content
POST
/
v2
/
vault-plus
/
media
/
batch
Get multiple media items with all quality variants
curl --request POST \
  --url https://api.ofauth.com/v2/vault-plus/media/batch \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <api-key>' \
  --header 'x-connection-id: <x-connection-id>' \
  --data '
{
  "mediaIds": [
    "4492994399",
    "4492994400"
  ]
}
'
{
  "items": [
    {
      "id": "4492994399",
      "type": "image",
      "duration": null,
      "media": {
        "full": {
          "status": "stored",
          "quality": "full",
          "sizeBytes": 1024000,
          "contentType": "image/jpeg",
          "accessCount": 12,
          "createdAt": 1715800000000,
          "expiresAt": 1715886400000,
          "storedAt": 1715800100000,
          "lastAccessedAt": 1715800500000,
          "url": "https://media.ofauth.com/v2/example-signed-media-url"
        },
        "thumb": {
          "status": "stored",
          "quality": "thumb",
          "sizeBytes": 32000,
          "contentType": "image/jpeg",
          "accessCount": 8,
          "createdAt": 1715800000000,
          "expiresAt": 1715886400000,
          "storedAt": 1715800100000,
          "lastAccessedAt": 1715800500000,
          "url": "https://media.ofauth.com/v2/example-signed-thumbnail-url"
        }
      }
    }
  ]
}

Authorizations

​
apiKey
string
header
required

Your OFAuth API key for authenticating requests.

Headers

​
x-connection-id
string
required

Connection ID whose Vault+ cache should be read or modified.

Minimum string length: 1
Example:

"conn_v5bsqkzsjfk8cgr7hqbbw09t"

Body

application/json

Batch media lookup request.

​
mediaIds
string[]
required

Raw OnlyFans media IDs to fetch. Maximum 100 IDs per request.

Maximum array length: 100

Raw OnlyFans media ID.

Example:
["4492994399", "4492994400"]

Response

Found media items with all cached variants. IDs that are not cached are omitted.

Batch media lookup response.

​
items
object[]
required

Found media items. Missing IDs are omitted from the response.