POST /api/v2/valuations/bulk
Personal access token & O auth2

Creates multiple valuations for a plan and sub-account

Headers

  • X-PLANNR-ACCOUNT-UUID string
application/json

Body

  • plan_uuid string(uuid) Required

    The UUID of the plan to store the valuations on.

  • sub_account_uuid string(uuid)

    The UUID of the plan's sub account to store the valuations on.

  • valuations array[object] Required

    The valuations to store. You can provide up to 1,000 valuations per request.

    Hide valuations attributes Show valuations attributes object
    • valued_at string(date)

      The date the valuation was made.

    • value integer

      The value represented in pennies.

    • bulk_reference_uuid string(uuid)

      Optional field to provide a unique UUIDv4 for your reference.

Responses

  • 401 application/json
    Hide response attribute Show response attribute object
    • message string
POST /api/v2/valuations/bulk 
curl \
 --request POST 'https://api.plannrcrm.com/api/v2/valuations/bulk' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"plan_uuid":"ee1154d1-4e72-4ba6-92f6-5559655ff9d4","sub_account_uuid":"c898cb15-bbf8-4fe4-8830-f3ddee9c2a10","valuations":[{"value":100000,"valued_at":"2025-01-01","bulk_reference_uuid":"05f3226a-79d1-43e5-9dac-81d5b24055ff"}]}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "plan_uuid": "ee1154d1-4e72-4ba6-92f6-5559655ff9d4",
  "sub_account_uuid": "c898cb15-bbf8-4fe4-8830-f3ddee9c2a10",
  "valuations": [
    {
      "value": 100000,
      "valued_at": "2025-01-01",
      "bulk_reference_uuid": "05f3226a-79d1-43e5-9dac-81d5b24055ff"
    }
  ]
}
Response examples (401) 
{
  "message": "Unauthenticated."
}