Vault

Lookup Vault Media by Hash

Checks whether the creator already has a vault media item matching the given MD5 hash + size. Returns the existing vault media object when there is a match, 404 otherwise. Call this before requesting signed upload URLs to skip re-uploading a duplicate file. Requires permission api_media_hash_lookup.

https://public-api.fansmetric.com

GET/v1/{account_id}/vault/media/hash

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Query Parameters

h*string
Lower-case MD5 hex of the file. For multipart files, use MD5(concatenation of part MD5 binaries) + "-" + partCount — the S3 multipart ETag format.
size*string
File size in bytes.

Response Fields

dataobject
Existing vault media object — same shape as entries in List Vault Media.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data	object	Existing vault media object — same shape as entries in List Vault Media.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/vault/media/hash?h=sample_h&size=sample_size" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"id":1234567890
"type":"photo"
"createdAt":"2026-04-12T08:00:00+00:00"
"isReady":true
"files":{"full":{"url":"https://public-api.fansmetric.com/media-proxy?url=...&exp=...&sig=..."
"width":1080
"height":1920
"size":234567
}
"thumb":{"url":"https://public-api.fansmetric.com/media-proxy?url=...&exp=...&sig=..."
"width":300
"height":533
}
}
"duration":0
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Vault Media Release Forms

Delete Vault Media