v1

latestOpenAPI 3.0.32026-07-132716.9 KB

marriage-allowance

Check Marriage Allowance eligibility

This resource checks whether an individual taxpayer's partner is eligible to become a recipient of Marriage Allowance for the given tax year.

This resource should only be used when the individual is the lower earner and is considering becoming a transferor of Marriage Allowance. It should only be used to to check the eligibility of their own partner.

post/marriage-allowance/sa/{utr}/eligibility

Path parameters

utrstring required

Example:2234567890

The 10 digit self-assessment UTR for the individual.

Request body

ninostring required

National Insurance number

firstnamestring required

Partner’s (potential recipient’s) first name

surnamestring required

Partner’s (potential recipient’s) surname

dateOfBirthstring required

Partner’s (potential recipient’s) date of birth in YYYY-MM-DD format

taxYearstring required

The tax year for which the Marriage Allowance eligibility is being retrieved, in the format YYYY-YY

Example request

{
  "nino": "AA000003D",
  "firstname": "John",
  "surname": "Wick",
  "dateOfBirth": "1987-12-20"
}

Response

eligibleboolean required

Whether the taxpayer's partner is eligible to become a recipient of Marriage Allowance.