When I use the Finder API, specifically post the example XML on their Developers page shown in the getIFPPlanBenefits sample to the URL https://api.finder.healthcare.gov/v3.0/getIFPPlanBenefits, I get this an HTTP 503, and this string:

File not found."

in the HTTP response. That's the sum total of the response.

I put the XML request in the body of my POST request and have remembered to set the Content-Type to application/xml

If I use a method name that's not valid, like https://api.finder.healthcare.gov/v3.0/notaname, I get an HTML response and an HTTP 200. The HTML response has some JS, and no visible text other than a noscript tag.

Has anyone else seen this, and what might I be doing wrong?

  • I don't see where on the site the API doesn't provide access to marketplace plans. can you please provide a more specific pointer?
    – user4032
    Nov 14, 2014 at 21:17

2 Answers 2


On the command line, give a try to the following successful request (or see/edit it in runscope):

$ curl -XPOST https://api.finder.healthcare.gov/v3.0/getIFPPlanQuotes -d '<?xml version="1.0" encoding="UTF-8"?>
<p:PlanQuoteRequest xmlns:p="http://hios.cms.org/api" xmlns:p1="http://hios.cms.org/api-types" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://hios.cms.org/api hios-api-11.0.xsd ">
    <p1:SortField>BASE RATE</p1:SortField>


FWIW, I was able to reproduce the 503 "File not found" by POSTing the same request but with trailing characters after the url like https://api.finder.healthcare.gov/v3.0/getIFPPlanQuotesXYZ


Adding details to @erik's answer above. Version 3.0 of the API only seems to return plans for effective dates greater than or equal to 01/01/2015. To get plans for 2014, you must still use Version 2.0 of the API here: https://finder.healthcare.gov/#services/version_2_0 (and marked as deprecated). Also it seems the effective date cannot be more than 150 days in the future.

In response to the question about the plan data not matching what is on healthcare.gov, please note that this API only returns Private Plans that are NOT in the Marketplace. The website finder.healthcare.gov uses the same API and tries to explain that on the home page here: https://finder.healthcare.gov/

Edit: sdwarwick below just pointed to this: https://www.healthcare.gov/health-plan-information-2015/ which is where you will find plans that are in the Marketplace. Stand Alone Dental Plans from the Marketplace are here: https://www.healthcare.gov/dental-plan-information-2015/

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.