Stream: CARIN IG for Blue Button®
Topic: service-date search type
Kate Dech (Jul 15 2020 at 23:08):
I have a question/possibly a suggestion about the search using service-date.
The datatype for this search parameter is a single 'date.' However, I would expect our consumers to want to search date ranges for all claims. (Note: I am working with Pharmacy EOBs that have a single date on the EOB for serviced-date, unlike IP EOBs that may leverage a period). Perhaps they want to start with claims in the last year, and then make a subsequent request for the year prior to that.
How can you specify in query parameters that you want EOBs with a servicedDate [lt][date1] but [ge][date2]?
We have another EOB API using base-FHIR and use the item.servicedPeriod as a search parameter to make it easier for requestors to supply the date boundaries:
GET /base/explanation-of-benefit/patient=[id]&item.servicedPeriod.start=2019-07-16&item.servicedPeriod.end=2020-07-15&_include=ExplanationOfBenefit:provider&_include=ExplanationOfBenefit:patient&_include=ExplanationOfBenefit:item.location
Curious if this would be allowed with the CBB profile.
FYI @Bapi Behera
Michele Mottini (Jul 15 2020 at 23:26):
You do ....&service-date=lt[date 1]&service-date=gt[date 2] - it is valid to specify the same search parameter multiple times, and they get combined with 'AND', that is what you need
Michele Mottini (Jul 15 2020 at 23:26):
...&item.servicedPeriod.end=2020-07-16 is not valid FHIR
Igor Sirkovich (Jul 16 2020 at 02:03):
@Kate Dech, I agree with Michele, servicePeriod.start and servicePeriod.end not valid in FHIR. You search for a date range by repeating the same Date/DateTime search parameter (as shown in Michele's example). The valid search parameter types in FHIR :
Number
Date/DateTime
String
Token
Reference
Composite
Quantity
URI
Special
Kate Dech (Jul 16 2020 at 12:49):
Thanks much!
Mona O (Aug 25 2020 at 23:27):
@Igor Sirkovich, @Michele Mottini , would you be able to further explain why searching on servicePeriod.start and servicePeriod.end are not valid in FHIR? Period datatype is of type DateTime. Thanks.
Michele Mottini (Aug 25 2020 at 23:44):
Search parameter are identified by a name - specific for each search parameter - and listed explicitly in the specs - so the valid search parameters for ExplanationOfBenefit are those listed here: http://hl7.org/fhir/explanationofbenefit.html#search. An implementation guide can add to that list, but again as specific parameters, you cannot just search on any element
Ryan Conley (Feb 01 2022 at 17:12):
I know this is an old thread, and I came to the same conclusions that were drawn here, but the docs are in contradiction to @Igor Sirkovich's point about the valid search parameter types. A type of Period is allowed, but this isn't a primitive type, so it couldn't/shouldn't really be passed as a parameter value. Is this an issue with the docs or have I misinterpreted?
http://www.hl7.org/fhir/search.html#date
Last updated: Apr 12 2022 at 19:14 UTC
