For Developers

Parse Human Names

Split, parse and clean human names into their component parts using GET or POST requests. Input from POST requests are limited to 500 lines. See the Ruby gem used in this service.

Base URL
https://api.bionomia.net/parse
?names=
human name(s); use \r\n as line breaks, all content escaped for GET requests (required)
Example GET
https://api.bionomia.net/parse?names=Henry+Robert+Nicollon+des+Abbayes%3B+Groom+Q%0D%0AMrs.+John+Errol+Chandos+Aberdeen
Example POST
curl -X POST -d $'names=Henry Robert Nicollon des Abbayes; Groom Q\r\nMrs. John Errol Chandos Aberdeen' https://api.bionomia.net/parse
Response
[
  {
    "original": "Henry Robert Nicollon des Abbayes; Groom Q",
    "parsed": [
      {
        "title": null,
        "appellation": null,
        "given": "Henry Robert Nicollon",
        "particle": "des",
        "family": "Abbayes",
        "suffix": null
      },
      {
        "title": null,
        "appellation": null,
        "given": "Q.",
        "particle": null,
        "family": "Groom",
        "suffix": null
      }
    ]
  },
  {
    "original": "Mrs. John Errol Chandos Aberdeen",
    "parsed": [
      {
        "title": null,
        "appellation": "Mrs.",
        "given": "John Errol Chandos",
        "particle": null,
        "family": "Aberdeen",
        "suffix": null
      }
    ]
  }
]