{"openapi":"3.1.0","info":{"title":"OpenScore care homes API for AI assistants","version":"1.0.0","description":"The OpenScore is a score from 0 to 10 that combines publicly available and provider-supplied information to make care homes easier to compare. Higher is better. It is not a regulator rating. A missing score (null) means the home has no published OpenScore; it never means zero.\n\nBefore searching, ask the care seeker the before_search questions; before creating a shortlist, the before_shortlist questions (see GET /guidance or https://map.openscore.org.uk/llms-full.txt). Never guess an answer.\n\nShow \"Source: OpenScore (openscore.org.uk)\" with any results. Link to each home's details or map URL when you mention it. Show the OpenScore as the OpenScore. It is not a regulator rating and must not be described as one. Describe distance_miles as straight-line distance, e.g. \"about 2.3 miles away in a straight line\".\n\nOpenScore is information to help shortlist care homes, not advice or a recommendation. Always visit, and check with the home and the regulator, before making a decision.","contact":{"url":"https://map.openscore.org.uk/agents"},"termsOfService":"https://map.openscore.org.uk/agents#terms"},"servers":[{"url":"https://map.openscore.org.uk/api/agent/v1"}],"paths":{"/guidance":{"get":{"operationId":"get_search_guidance","summary":"Question bank and guidance","description":"Returns the OpenScore question bank in order (wording, why each matters, accepted answers), situation guidance, funding routes, attribution and privacy rules. Call this first if you plan the conversation up front.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[]}},"/search":{"post":{"operationId":"search_care_homes","summary":"Search near a postcode or town","description":"Finds care homes near a UK postcode or town. OpenScore chooses the search radius from the number of suitable homes nearby, so do not ask for a radius. Before calling, ask the care seeker every before_search question: location, who_is_asking, admission_timescale, current_situation, care_type, funding, priorities. Returns homes with distance, OpenScore, regulator rating, contact details and links, plus search_area, situation guidance, next steps, intake_status and a map_url to give the care seeker.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"postcode_or_town":{"type":"string","minLength":2,"maxLength":100,"description":"Where to search: a UK postcode (best) or a town, from the care seeker."},"max_distance_miles":{"type":"number","minimum":0.5,"maximum":50,"description":"Only if the care seeker gave a limit on distance. Never exceeded."},"more_results":{"type":"boolean","description":"true when the care seeker asks to see more homes (doubles the target, up to 50)."},"sort":{"type":"string","enum":["priorities","openscore"],"description":"Leave out to order by the care seeker's priorities (OpenScore keeps half the weight); \"openscore\" for plain OpenScore order."},"intake":{"type":"object","description":"The care seeker's answers to the before_search questions. Every listed field is required; ask them before calling.","properties":{"who_is_asking":{"type":"string","enum":["self","parent","partner","other_relative","friend","professional","not_sure","prefer_not_to_say"],"description":"Are you looking for yourself, or for someone else? Why: It lets the conversation talk about the right person in the right way. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"admission_timescale":{"type":"string","enum":["within_2_weeks","within_1_month","within_3_months","planning_ahead","not_sure","prefer_not_to_say"],"description":"How soon does {person} need to move in? Why: It sets the pace of the search. With a few weeks, the next step is contacting homes about availability and arranging visits; with longer, it is visiting, attending open days and comparing areas. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"current_situation":{"type":"string","enum":["at_home_no_care","at_home_family_care","at_home_home_care","in_respite","hospital_discharge","in_care_home","sheltered_or_supported","other","not_sure","prefer_not_to_say"],"description":"Where is {person} living now, and what support do they have? Why: The right first steps differ a great deal between, for example, a hospital discharge and planning ahead from home. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"care_type":{"type":"array","items":{"type":"string","enum":["residential","nursing","dementia","not_sure","prefer_not_to_say"]},"minItems":1,"description":"Does {person} need help with personal care, nursing care from a registered nurse, or care for dementia? It's fine to say you're not sure. Why: Homes are registered for particular types of care, so this decides which homes can be considered. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"funding":{"type":"string","enum":["self_funding","la_funding","la_topup_funding","chc_funding","not_sure","prefer_not_to_say"],"description":"Do you know how the care will be paid for? Why: Not every home accepts every kind of funding, and the funding route changes the next steps. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"priorities":{"type":"object","description":"What's the most important part of the home you choose? And what's the least important? (Fees, the manager, location, activities, or the care offered.) Why: Everyone weighs these differently, and almost no one asks. Knowing what matters most lets OpenScore order the homes for this person. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess.","properties":{"most_important":{"type":"string","enum":["fees","manager","location","activities","care_offered","not_sure","prefer_not_to_say"],"description":"The care seeker's most important factor."},"least_important":{"type":"string","enum":["fees","manager","location","activities","care_offered","not_sure","prefer_not_to_say"],"description":"The care seeker's least important factor; must differ from most_important."},"full_ranking":{"type":"array","items":{"type":"string","enum":["fees","manager","location","activities","care_offered"]},"minItems":5,"maxItems":5,"description":"Optional: all five factors in order, most important first, only if the care seeker has ranked them all."}},"required":["most_important","least_important"],"additionalProperties":false},"social_life":{"type":"string","enum":["very_social","small_groups","quiet","varies","not_sure","prefer_not_to_say"],"description":"How much does {person} enjoy being around other people? Would they rather be in the middle of things, or have somewhere quiet to retreat to? Why: The atmosphere and daily routine differ a great deal between homes, and a mismatch is a common reason a move goes badly. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"interests_and_hobbies":{"type":"string","maxLength":500,"description":"What does {person} most enjoy doing? Any hobbies, interests or things that always lift their mood? Why: Homes differ in what they offer, and the answer turns into specific things to look for and ask about. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess. Free text; used within this request only and never stored."},"other_preferences":{"type":"string","maxLength":500,"description":"Is there anything else that would make a home right for {person}? For example a pet moving with them, faith or cultural needs, their first language, a garden, or being close to particular family. Why: These are often the details that decide between two otherwise similar homes. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess. Free text; used within this request only and never stored."},"interest_categories":{"type":"array","items":{"type":"string","enum":["music_performance","animals","sport","outings","talks_learning","gardening_outdoors","faith","arts_crafts","games_puzzles","cooking","other"]},"description":"Optional: categories for interests_and_hobbies. OpenScore also derives them from the free text."}},"required":["who_is_asking","admission_timescale","current_situation","care_type","funding","priorities"],"additionalProperties":false},"agent":{"type":"object","description":"Optional: your assistant's name and version, for attribution.","properties":{"name":{"type":"string","maxLength":64},"version":{"type":"string","maxLength":64}},"additionalProperties":false}},"required":["postcode_or_town","intake"],"additionalProperties":false}}}}}},"/search/area":{"post":{"operationId":"search_care_homes_by_area","summary":"Search a directory area","description":"Lists every matching care home in a county, region or local authority (get the area and location values from find_locations), paged. Optionally give postcode_or_town to add distance_miles. Before calling, ask the care seeker every before_search question: who_is_asking, admission_timescale, current_situation, care_type, funding, priorities.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"area":{"type":"string","description":"area_search.area from find_locations (region slug)."},"location":{"type":"string","description":"area_search.location from find_locations (local authority slug), when present."},"postcode_or_town":{"type":"string","minLength":2,"maxLength":100,"description":"Optional: a place to measure distance from."},"page":{"type":"integer","minimum":1,"description":"Page number, from 1."},"page_size":{"type":"integer","minimum":1,"maximum":100,"description":"Homes per page (default 25, max 100)."},"sort":{"type":"string","enum":["priorities","openscore"],"description":"Leave out to order by the care seeker's priorities (OpenScore keeps half the weight); \"openscore\" for plain OpenScore order."},"intake":{"type":"object","description":"The care seeker's answers to the before_search questions. Every listed field is required; ask them before calling.","properties":{"who_is_asking":{"type":"string","enum":["self","parent","partner","other_relative","friend","professional","not_sure","prefer_not_to_say"],"description":"Are you looking for yourself, or for someone else? Why: It lets the conversation talk about the right person in the right way. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"admission_timescale":{"type":"string","enum":["within_2_weeks","within_1_month","within_3_months","planning_ahead","not_sure","prefer_not_to_say"],"description":"How soon does {person} need to move in? Why: It sets the pace of the search. With a few weeks, the next step is contacting homes about availability and arranging visits; with longer, it is visiting, attending open days and comparing areas. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"current_situation":{"type":"string","enum":["at_home_no_care","at_home_family_care","at_home_home_care","in_respite","hospital_discharge","in_care_home","sheltered_or_supported","other","not_sure","prefer_not_to_say"],"description":"Where is {person} living now, and what support do they have? Why: The right first steps differ a great deal between, for example, a hospital discharge and planning ahead from home. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"care_type":{"type":"array","items":{"type":"string","enum":["residential","nursing","dementia","not_sure","prefer_not_to_say"]},"minItems":1,"description":"Does {person} need help with personal care, nursing care from a registered nurse, or care for dementia? It's fine to say you're not sure. Why: Homes are registered for particular types of care, so this decides which homes can be considered. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"funding":{"type":"string","enum":["self_funding","la_funding","la_topup_funding","chc_funding","not_sure","prefer_not_to_say"],"description":"Do you know how the care will be paid for? Why: Not every home accepts every kind of funding, and the funding route changes the next steps. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"priorities":{"type":"object","description":"What's the most important part of the home you choose? And what's the least important? (Fees, the manager, location, activities, or the care offered.) Why: Everyone weighs these differently, and almost no one asks. Knowing what matters most lets OpenScore order the homes for this person. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess.","properties":{"most_important":{"type":"string","enum":["fees","manager","location","activities","care_offered","not_sure","prefer_not_to_say"],"description":"The care seeker's most important factor."},"least_important":{"type":"string","enum":["fees","manager","location","activities","care_offered","not_sure","prefer_not_to_say"],"description":"The care seeker's least important factor; must differ from most_important."},"full_ranking":{"type":"array","items":{"type":"string","enum":["fees","manager","location","activities","care_offered"]},"minItems":5,"maxItems":5,"description":"Optional: all five factors in order, most important first, only if the care seeker has ranked them all."}},"required":["most_important","least_important"],"additionalProperties":false},"social_life":{"type":"string","enum":["very_social","small_groups","quiet","varies","not_sure","prefer_not_to_say"],"description":"How much does {person} enjoy being around other people? Would they rather be in the middle of things, or have somewhere quiet to retreat to? Why: The atmosphere and daily routine differ a great deal between homes, and a mismatch is a common reason a move goes badly. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"interests_and_hobbies":{"type":"string","maxLength":500,"description":"What does {person} most enjoy doing? Any hobbies, interests or things that always lift their mood? Why: Homes differ in what they offer, and the answer turns into specific things to look for and ask about. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess. Free text; used within this request only and never stored."},"other_preferences":{"type":"string","maxLength":500,"description":"Is there anything else that would make a home right for {person}? For example a pet moving with them, faith or cultural needs, their first language, a garden, or being close to particular family. Why: These are often the details that decide between two otherwise similar homes. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess. Free text; used within this request only and never stored."},"interest_categories":{"type":"array","items":{"type":"string","enum":["music_performance","animals","sport","outings","talks_learning","gardening_outdoors","faith","arts_crafts","games_puzzles","cooking","other"]},"description":"Optional: categories for interests_and_hobbies. OpenScore also derives them from the free text."}},"required":["who_is_asking","admission_timescale","current_situation","care_type","funding","priorities"],"additionalProperties":false},"agent":{"type":"object","description":"Optional: your assistant's name and version, for attribution.","properties":{"name":{"type":"string","maxLength":64},"version":{"type":"string","maxLength":64}},"additionalProperties":false}},"required":["area","intake"],"additionalProperties":false}}}}}},"/locations":{"get":{"operationId":"find_locations","summary":"Find areas by name","description":"Turns a place name (e.g. \"Croydon\", \"Surrey\") into directory areas, with the area_search values for search_care_homes_by_area, home counts and the area page link.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"q","in":"query","required":true,"description":"Place name.","schema":{"type":"string","minLength":2}}]}},"/care-homes/{id}":{"get":{"operationId":"get_care_home","summary":"One care home","description":"One care home by its OpenScore id, with upcoming events, feedback, contact details and links. Optionally pass the person's interests to get match_notes and questions to ask.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"id","in":"path","required":true,"description":"The id field of a home returned by a search.","schema":{"type":"integer","minimum":1}},{"name":"interests","in":"query","required":false,"description":"Optional: interests and hobbies, as text or comma-separated categories.","schema":{"type":"string","maxLength":500}}]}},"/areas/compare":{"get":{"operationId":"compare_areas","summary":"League Table figures","description":"League Table figures for areas: average OpenScore, coverage, care types, regulator ratings and validated average fees. Give area ids from find_locations, or a country and level. Areas with fewer than 11 care homes are not ranked.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"ids","in":"query","required":false,"description":"Area ids from find_locations.","schema":{"type":"array","items":{"type":"string"},"maxItems":20},"style":"form","explode":false},{"name":"country","in":"query","required":false,"description":"List every area in a country.","schema":{"type":"string","enum":["england","scotland","wales","northern_ireland"]}},{"name":"level","in":"query","required":false,"description":"Counties and regions, or local authorities.","schema":{"type":"string","enum":["county","local_authority"]}}]}},"/events":{"get":{"operationId":"find_events","summary":"Upcoming events near a place","description":"Upcoming events and open days at care homes near a place. Useful when the care seeker is planning ahead, or to match their interests.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"postcode_or_town","in":"query","required":true,"description":"Where to look.","schema":{"type":"string","minLength":2,"maxLength":100}},{"name":"radius_miles","in":"query","required":false,"description":"Search radius in miles (default 10).","schema":{"type":"number","minimum":0.5,"maximum":25}},{"name":"event_type","in":"query","required":false,"description":"Optional event type, e.g. \"Open Day\", \"Performance\", \"Pet therapy\".","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Optional earliest start date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Optional latest start date (YYYY-MM-DD).","schema":{"type":"string","format":"date"}}]}},"/shortlist":{"post":{"operationId":"create_shortlist_link","summary":"Create a shortlist link","description":"Creates a link that opens the chosen homes on the OpenScore map (with the search behind them when search_id is given), and a \"your search\" summary with questions to ask each home. Before calling, ask the before_shortlist questions as well: social_life, interests_and_hobbies, other_preferences. Sends no email and contacts no one.","responses":{"200":{"description":"Success. Includes source, notice and attribution, which must be shown with results.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Missing or invalid input. error.hint says what to ask or change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (60/minute, 1000/day per IP).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"integer","minimum":1},"minItems":1,"maxItems":20,"description":"Ids of the homes to keep, most preferred first."},"search_id":{"type":"string","description":"Optional: the search_id of the search the homes came from."},"intake":{"type":"object","description":"The care seeker's answers to every question (before_search and before_shortlist). Every listed field is required; ask them before calling.","properties":{"who_is_asking":{"type":"string","enum":["self","parent","partner","other_relative","friend","professional","not_sure","prefer_not_to_say"],"description":"Are you looking for yourself, or for someone else? Why: It lets the conversation talk about the right person in the right way. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"admission_timescale":{"type":"string","enum":["within_2_weeks","within_1_month","within_3_months","planning_ahead","not_sure","prefer_not_to_say"],"description":"How soon does {person} need to move in? Why: It sets the pace of the search. With a few weeks, the next step is contacting homes about availability and arranging visits; with longer, it is visiting, attending open days and comparing areas. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"current_situation":{"type":"string","enum":["at_home_no_care","at_home_family_care","at_home_home_care","in_respite","hospital_discharge","in_care_home","sheltered_or_supported","other","not_sure","prefer_not_to_say"],"description":"Where is {person} living now, and what support do they have? Why: The right first steps differ a great deal between, for example, a hospital discharge and planning ahead from home. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"care_type":{"type":"array","items":{"type":"string","enum":["residential","nursing","dementia","not_sure","prefer_not_to_say"]},"minItems":1,"description":"Does {person} need help with personal care, nursing care from a registered nurse, or care for dementia? It's fine to say you're not sure. Why: Homes are registered for particular types of care, so this decides which homes can be considered. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"funding":{"type":"string","enum":["self_funding","la_funding","la_topup_funding","chc_funding","not_sure","prefer_not_to_say"],"description":"Do you know how the care will be paid for? Why: Not every home accepts every kind of funding, and the funding route changes the next steps. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"priorities":{"type":"object","description":"What's the most important part of the home you choose? And what's the least important? (Fees, the manager, location, activities, or the care offered.) Why: Everyone weighs these differently, and almost no one asks. Knowing what matters most lets OpenScore order the homes for this person. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess.","properties":{"most_important":{"type":"string","enum":["fees","manager","location","activities","care_offered","not_sure","prefer_not_to_say"],"description":"The care seeker's most important factor."},"least_important":{"type":"string","enum":["fees","manager","location","activities","care_offered","not_sure","prefer_not_to_say"],"description":"The care seeker's least important factor; must differ from most_important."},"full_ranking":{"type":"array","items":{"type":"string","enum":["fees","manager","location","activities","care_offered"]},"minItems":5,"maxItems":5,"description":"Optional: all five factors in order, most important first, only if the care seeker has ranked them all."}},"required":["most_important","least_important"],"additionalProperties":false},"social_life":{"type":"string","enum":["very_social","small_groups","quiet","varies","not_sure","prefer_not_to_say"],"description":"How much does {person} enjoy being around other people? Would they rather be in the middle of things, or have somewhere quiet to retreat to? Why: The atmosphere and daily routine differ a great deal between homes, and a mismatch is a common reason a move goes badly. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess."},"interests_and_hobbies":{"type":"string","maxLength":500,"description":"What does {person} most enjoy doing? Any hobbies, interests or things that always lift their mood? Why: Homes differ in what they offer, and the answer turns into specific things to look for and ask about. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess. Free text; used within this request only and never stored."},"other_preferences":{"type":"string","maxLength":500,"description":"Is there anything else that would make a home right for {person}? For example a pet moving with them, faith or cultural needs, their first language, a garden, or being close to particular family. Why: These are often the details that decide between two otherwise similar homes. The value must come from the care seeker. Use not_sure if they do not know and prefer_not_to_say if they would rather not answer; never guess. Free text; used within this request only and never stored."},"interest_categories":{"type":"array","items":{"type":"string","enum":["music_performance","animals","sport","outings","talks_learning","gardening_outdoors","faith","arts_crafts","games_puzzles","cooking","other"]},"description":"Optional: categories for interests_and_hobbies. OpenScore also derives them from the free text."}},"required":["who_is_asking","admission_timescale","current_situation","care_type","funding","priorities","social_life","interests_and_hobbies","other_preferences"],"additionalProperties":false},"agent":{"type":"object","description":"Optional: your assistant's name and version, for attribution.","properties":{"name":{"type":"string","maxLength":64},"version":{"type":"string","maxLength":64}},"additionalProperties":false}},"required":["ids","intake"],"additionalProperties":false}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string","description":"What to do next, e.g. the question to ask the care seeker."},"field":{"type":"string"}},"required":["code","message","hint"]}},"required":["error"]}}},"externalDocs":{"description":"Guide for AI assistants","url":"https://map.openscore.org.uk/llms-full.txt"}}