Vault

Get Vault Media Release Forms

Returns the release form(s) attached to a vault media item. A release form is the contract/consent record OnlyFans requires when other people appear in the content. Use this to display signing status, tagged users, and form metadata. Requires permission api_vault_read_release_forms.

https://public-api.fansmetric.com
GET/v1/{account_id}/vault/media/{media_id}/release-forms
Bearer

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.

  • media_id*integer

    The vault media ID. Numeric.

Response Fields

  • data[]array

    Release forms attached to the media. Empty array if none.

  • data[].idinteger

    Release form ID.

  • data[].namestring

    Display name of the release form template.

  • data[].statusstring

    Signing status — typically signed, pending, or declined.

  • data[].users[]array

    Users tagged on the form with their individual signing status.

  • dataobject | array

    Endpoint-specific payload. See the fields below for this route.

  • _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.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/vault/media/sample_media_id/release-forms" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":[
0:{
"id":42
"name":"Standard Model Release"
"status":"signed"
"createdAt":"2026-04-01T12:00:00+00:00"
"users":[
0:{
"id":987
"username":"guest_model"
"status":"signed"
}
]
}
]
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}