Application API Profile criteria POST

October 15, 2026 at 9:35 AM

/members/self/criteria [POST]

Update any My Match search criteria for the current member - protected.

Parameters

Takes as parameters any search criteria that can be returned from GET /members/self/criteria. For example:

  • age - hash map of from and to values
  • country - hash map of value (a 2-letter code)

Response Messages

403 Forbidden

The possible failcode entries include:

  • 31000 - the criterion value is ill-formed (not a hash map)
  • 31003 - a general criterion value does not contain either value or values
  • 31004 - a range criterion value does not contain to and from, or their values are not numeric, or the from value is higher than the to value
  • 31005 - an age range criterion value has to and/or from values outside the range 18..120
  • 31006 - a geolocation criterion does not contain within and of values, or the within value is not a numeric value from the set -1, 20, 30, 40, 50, 150, 500, 1000
  • 31007 - a geolocation criterion has a within value of 20, 30, 40, or 50 but the member is not platinum (only platinum members can specify those smaller distances)
  • 31008 - the criterion is only available to platinum members (the current member is not a subscriber)
  • 31009 - the criterion value(s) specified are not legal for this criterion (e.g., 50 for smoking, which only has 10, 20, 30, and 40 as legal values)
  • 31010 - the country criterion value is illegal (not a valid two-letter ISO code)
  • 31011 - the zipcode criterion value is illegal (for the member’s country)
{ "fail" : "Invalid Argument", "failcode" : [ ... ] }

Additional failcode entries will be added as more validation is fleshed out for this API.

200 OK - success

The response is the set of updated search criteria, as if GET /members/self/criteria had been called.