VercelVercel
Menu

Validate Resources Transfer Request

GET/v1/installations/{installationId}/resource-transfer-requests/{providerClaimId}/verify
Vercel uses this endpoint to provide a potential target for the transfer, and to request any necessary information for prerequisite setup to support the resources in the target team upon completion of the transfer. Multiple sources/teams may verify the same transfer. Only transfers that haven't been completed can be verified.
Important: The installation ID in the URL is the target installation ID, not the source one.
/v1/installations/{installationId}/resource-transfer-requests/{providerClaimId}/verify
const response = await fetch('/v1/installations/string/resource-transfer-requests/string/verify', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});


const data = await response.json();
console.log(data);
Response
{
  "newBillingPlan": {
    "id": "string",
    "type": "prepayment",
    "name": "string",
    "scope": "installation",
    "description": "string",
    "paymentMethodRequired": "true",
    "preauthorizationAmount": "123",
    "initialCharge": "string",
    "minimumAmount": "string",
    "maximumAmount": "string",
    "maximumAmountAutoPurchasePerPeriod": "string",
    "cost": "string",
    "details": [],
    "highlightedDetails": [],
    "quote": [],
    "effectiveDate": "string",
    "disabled": "true"
  }
}

Authentication

AuthorizationSystem Authentication

Default authentication mechanism

Path parameters

installationIdstringRequired
providerClaimIdstringRequired

Header parameters

X-Vercel-AuthstringOptional
The auth style used in the request (system, user, etc)

Response

Transfer request verified successfully
newBillingPlanobjectOptional
The new billing plan required for the transfer. This is only required when the current installation's billing plan is not sufficient (should never be the case for free-tier resources).

Errors

403Operation failed because the authentication is not allowed to perform this operation
404Entity not found
409Operation failed because of a conflict with the current state of the resource
422Operation is well-formed, but cannot be executed due to semantic errors
Validate Resources Transfer Request | Partner API