{"openapi":"3.1.0","info":{"title":"Merlin Data API","description":"Datasheet specs and extracted curves for power-electronics parts, in SI units.\n\n## Pre-release\n\nv1 is in pre-release, available to pilot partners, until version 1.0.0. Until then any part of it may change, including breaking changes. The policy below applies from 1.0.0 on.\n\n## Change policy\n\n- **Additive only within v1.** We may add endpoints, optional query parameters and body fields, response fields, and new enum values. Ignore fields you don't recognise and accept enum values you haven't seen: every enum is extensible, typed in the schema as its known values or any other string.\n- **Never within v1:** removing or renaming a field, or changing a field's type, unit, meaning or default. A breaking change ships as /v2 beside /v1, discussed with customers first and announced with notice, and v1 keeps running through an overlap.\n- **Units are part of the contract.** Every value is in unprefixed SI units (Ω, F, C, A, V, W, J, S, s, Hz), except temperatures in °C, thermal resistances in °C/W and ratios in %. Each value names its unit.\n- **Unknown query parameters and body fields are rejected** with 422, so a parameter or field added later never changes what an accepted request returns.\n- **Data is live.** Values change when a part is re-extracted; that is a data change, not an API change.\n","version":"0.4.0"},"servers":[{"url":"https://api.get-merlin.com/v1"}],"paths":{"/mosfets/{part_number}":{"get":{"tags":["mosfets"],"summary":"Get a MOSFET","description":"A MOSFET's datasheet specs and every extracted curve.","operationId":"get_mosfet","security":[{"ApiKey":[]}],"parameters":[{"name":"part_number","in":"path","required":true,"schema":{"type":"string","description":"Manufacturer part number, matched exactly (ignoring case and surrounding whitespace).","examples":["ISCH42N04LM7"],"title":"Part Number"},"description":"Manufacturer part number, matched exactly (ignoring case and surrounding whitespace)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mosfet"}}}},"401":{"description":"No API key, or one that is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"This API key is invalid, expired or revoked.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unauthorized","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"403":{"description":"The API key's account isn't on a plan that includes the Data API.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"This API key's account isn't on a plan that includes the Data API.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#forbidden","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"429":{"description":"More than 120 requests in a minute from this API key's account, all its keys together, or a flood of requests from one IP address.","headers":{"Retry-After":{"description":"Seconds to wait before retrying: until the account's oldest request in the minute expires, or 1 for the per-IP limit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"rate_limited","message":"This account's API keys sent more than 120 requests in a minute; retry after Retry-After seconds.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#rate_limited","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"404":{"description":"No catalogue part has exactly this part number. `candidates` lists close matches when there are any.","content":{"application/json":{"example":{"error":{"code":"not_found","message":"No MOSFET with part number ISCH42N04LM7X is in the catalogue.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#not_found","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":[{"part_number":"ISCH42N04LM7","manufacturer":"Infineon","family":"mosfet","url":"https://api.get-merlin.com/v1/mosfets/ISCH42N04LM7"}]}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"The request is malformed or has unknown parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"invalid_request","message":"Unknown query parameter: fields.","param":"fields","doc_url":"https://www.get-merlin.com/docs/errors#invalid_request","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"500":{"description":"An unexpected error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"internal_error","message":"Internal server error.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#internal_error","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"502":{"description":"The Data API is unavailable; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"The Data API is unavailable; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":null,"candidates":null}}}}},"503":{"description":"API keys can't be verified right now; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"API keys can't be verified right now; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"504":{"description":"The lookup, or the Data API, didn't answer in time; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"The lookup timed out; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}}}}},"/mosfets/tradeoffs":{"post":{"tags":["mosfets"],"summary":"Search MOSFET trade-offs","description":"Every N-channel MOSFET matching the filters, with its R_DS(on) and Q_g\nread off its datasheet curves at the operating point and its Pareto rank,\none point per orderable part.\n\nValues are typical, at 25 °C. When a datasheet doesn't print the\nrequested gate drive, R_DS(on) is read at the next printed drive down and\nits `conditions.V_GS` says which: a worst case, since R_DS(on) rises as\nV_GS falls. Counts as one request and no matched parts.","operationId":"search_mosfet_tradeoffs","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MosfetTradeoffRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MosfetTradeoffs"},"example":{"operating_point":{"V_GS":{"value":10.0,"unit":"V"},"I_D":{"value":10.0,"unit":"A"},"V_DS":{"value":24.0,"unit":"V"}},"axes":["R_DS_on","Q_g"],"excluded":[{"reason":"no_r_ds_on_curve","count":207},{"reason":"no_reading_at_i_d","count":89},{"reason":"no_gate_charge_curve","count":71},{"reason":"gate_charge_short_of_v_gs","count":27}],"data":[{"part":{"part_number":"IQFH39N04NM6","manufacturer":"Infineon","family":"mosfet","url":"https://api.get-merlin.com/v1/mosfets/IQFH39N04NM6"},"rank":0,"values":{"R_DS_on":{"quantity":{"value":0.0002679,"unit":"Ω"},"plot":"rds_on_vs_id","conditions":{"V_GS":{"value":10.0,"unit":"V"},"I_D":{"value":10.0,"unit":"A"},"T_j":{"value":25.0,"unit":"°C"}}},"Q_g":{"quantity":{"value":1.811e-07,"unit":"C"},"plot":"gate_charge","conditions":{"V_GS":{"value":10.0,"unit":"V"},"V_DD":{"value":20.0,"unit":"V"},"T_j":{"value":25.0,"unit":"°C"}}}}},{"part":{"part_number":"NVMFWS0D4N04XM","manufacturer":"onsemi","family":"mosfet","url":"https://api.get-merlin.com/v1/mosfets/NVMFWS0D4N04XM"},"rank":0,"values":{"R_DS_on":{"quantity":{"value":0.0003356,"unit":"Ω"},"plot":"output_characteristics","conditions":{"V_GS":{"value":10.0,"unit":"V"},"I_D":{"value":10.0,"unit":"A"},"T_j":{"value":25.0,"unit":"°C"}}},"Q_g":{"quantity":{"value":1.328e-07,"unit":"C"},"plot":"gate_charge","conditions":{"V_GS":{"value":10.0,"unit":"V"},"V_DD":{"value":24.0,"unit":"V"},"T_j":{"value":25.0,"unit":"°C"}}}}},{"part":{"part_number":"IQDH35N03LM5","manufacturer":"Infineon","family":"mosfet","url":"https://api.get-merlin.com/v1/mosfets/IQDH35N03LM5"},"rank":1,"values":{"R_DS_on":{"quantity":{"value":0.0003082,"unit":"Ω"},"plot":"rds_on_vs_id","conditions":{"V_GS":{"value":10.0,"unit":"V"},"I_D":{"value":10.0,"unit":"A"},"T_j":{"value":25.0,"unit":"°C"}}},"Q_g":{"quantity":{"value":1.988e-07,"unit":"C"},"plot":"gate_charge","conditions":{"V_GS":{"value":10.0,"unit":"V"},"V_DD":{"value":24.0,"unit":"V"},"T_j":{"value":25.0,"unit":"°C"}}}}},{"part":{"part_number":"ISCH42N04LM7","manufacturer":"Infineon","family":"mosfet","url":"https://api.get-merlin.com/v1/mosfets/ISCH42N04LM7"},"rank":2,"values":{"R_DS_on":{"quantity":{"value":0.0003855,"unit":"Ω"},"plot":"rds_on_vs_id","conditions":{"V_GS":{"value":10.0,"unit":"V"},"I_D":{"value":10.0,"unit":"A"},"T_j":{"value":25.0,"unit":"°C"}}},"Q_g":{"quantity":{"value":1.563e-07,"unit":"C"},"plot":"gate_charge","conditions":{"V_GS":{"value":10.0,"unit":"V"},"V_DD":{"value":20.0,"unit":"V"},"T_j":{"value":25.0,"unit":"°C"}}}}}]}}}},"401":{"description":"No API key, or one that is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"This API key is invalid, expired or revoked.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unauthorized","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"403":{"description":"The API key's account isn't on a plan that includes the Data API.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"This API key's account isn't on a plan that includes the Data API.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#forbidden","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"429":{"description":"More than 120 requests in a minute from this API key's account, all its keys together, or a flood of requests from one IP address.","headers":{"Retry-After":{"description":"Seconds to wait before retrying: until the account's oldest request in the minute expires, or 1 for the per-IP limit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"rate_limited","message":"This account's API keys sent more than 120 requests in a minute; retry after Retry-After seconds.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#rate_limited","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"422":{"description":"The body is malformed, has an unknown field or no filter, or sends a value that isn't above zero or is in another unit. `message` names each field and the rule it broke.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"invalid_request","message":"operating_point.V_GS.unit: Input should be 'V'","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#invalid_request","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"500":{"description":"An unexpected error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"internal_error","message":"Internal server error.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#internal_error","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"502":{"description":"The Data API is unavailable; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"The Data API is unavailable; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":null,"candidates":null}}}}},"503":{"description":"API keys can't be verified right now, or the trade-off table couldn't be built. Retry shortly; the second sends Retry-After.","headers":{"Retry-After":{"description":"Seconds to wait before retrying. Sent when the trade-off table couldn't be built.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"API keys can't be verified right now; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"504":{"description":"The lookup, or the Data API, didn't answer in time; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"The lookup timed out; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}}},"security":[{"ApiKey":[]}]}},"/capacitors/{part_number}":{"get":{"tags":["capacitors"],"summary":"Get a capacitor","description":"A capacitor's specs and every vendor curve. Fields only one\ntechnology has sit under that technology's object, such as `ceramic`.","operationId":"get_capacitor","security":[{"ApiKey":[]}],"parameters":[{"name":"part_number","in":"path","required":true,"schema":{"type":"string","description":"Manufacturer part number, matched exactly (ignoring case and surrounding whitespace).","examples":["C1206C475K5PACTU"],"title":"Part Number"},"description":"Manufacturer part number, matched exactly (ignoring case and surrounding whitespace)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capacitor"},"example":{"part_number":"C1206C475K5PACTU","manufacturer":"Kemet","family":"capacitor","datasheet_url":null,"product_url":"https://www.yageogroup.com/products/Capacitors/part/C1206C475K5PACTU","package":"1206","temperature_range":[{"min":-55.0,"typ":null,"max":85.0,"unit":"°C","conditions_text":null}],"qualifications":null,"environmental_status":null,"product_status":null,"mounting_type":null,"technology":"ceramic","capacitance":[{"min":null,"typ":4.7e-06,"max":null,"unit":"F","conditions_text":null}],"voltage_rating":[{"min":null,"typ":50.0,"max":null,"unit":"V","conditions_text":null}],"tolerance":[{"min":null,"typ":10.0,"max":null,"unit":"%","conditions_text":null}],"impedance":[{"plot_type":"impedance","x":{"label":"f","unit":"Hz","scale":"log"},"y":{"label":"Z","unit":"Ω","scale":"log"},"conditions_text":null,"curves":[{"label":"","points":[[100.0,333.285],[1000000.0,0.0329296],[10000000000.0,30.8637]]}]}],"esr":[{"plot_type":"esr","x":{"label":"f","unit":"Hz","scale":"log"},"y":{"label":"ESR","unit":"Ω","scale":"log"},"conditions_text":null,"curves":[{"label":"","points":[[100.0,7.74555],[1000000.0,0.00522827],[10000000000.0,10.7221]]}]}],"ripple_current":[{"plot_type":"ripple_current","x":{"label":"I_ripple","unit":"A","scale":"linear"},"y":{"label":"T_rise","unit":"°C","scale":"linear"},"conditions_text":null,"curves":[{"label":"f=100 kHz","points":[[0.484038,0.1],[4.32937,8.0],[11.4544,56.0]]}]}],"ceramic":{"dielectric":"X5R","dc_bias":[{"plot_type":"dc_bias","x":{"label":"V_bias","unit":"V","scale":"linear"},"y":{"label":"C_retention","unit":"%","scale":"linear"},"conditions_text":null,"curves":[{"label":"","points":[[0.0,100.0],[25.0,24.0],[49.5,12.1212]]}]}]}}}}},"401":{"description":"No API key, or one that is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"This API key is invalid, expired or revoked.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unauthorized","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"403":{"description":"The API key's account isn't on a plan that includes the Data API.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"This API key's account isn't on a plan that includes the Data API.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#forbidden","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"429":{"description":"More than 120 requests in a minute from this API key's account, all its keys together, or a flood of requests from one IP address.","headers":{"Retry-After":{"description":"Seconds to wait before retrying: until the account's oldest request in the minute expires, or 1 for the per-IP limit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"rate_limited","message":"This account's API keys sent more than 120 requests in a minute; retry after Retry-After seconds.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#rate_limited","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"404":{"description":"No catalogue part has exactly this part number. `candidates` lists close matches when there are any.","content":{"application/json":{"example":{"error":{"code":"not_found","message":"No capacitor with part number C1206C475K5PACTUX is in the catalogue.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#not_found","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":[{"part_number":"C1206C475K5PACTU","manufacturer":"Kemet","family":"capacitor","url":"https://api.get-merlin.com/v1/capacitors/C1206C475K5PACTU"}]}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"The request is malformed or has unknown parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"invalid_request","message":"Unknown query parameter: fields.","param":"fields","doc_url":"https://www.get-merlin.com/docs/errors#invalid_request","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"500":{"description":"An unexpected error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"internal_error","message":"Internal server error.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#internal_error","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"502":{"description":"The Data API is unavailable; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"The Data API is unavailable; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":null,"candidates":null}}}}},"503":{"description":"API keys can't be verified right now; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"API keys can't be verified right now; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}},"504":{"description":"The lookup, or the Data API, didn't answer in time; retry shortly.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unavailable","message":"The lookup timed out; retry shortly.","param":null,"doc_url":"https://www.get-merlin.com/docs/errors#unavailable","request_id":"4f9c2b7e1d8a4e6b9c3f5a7d2e1b8c4a","candidates":null}}}}}}}}},"components":{"schemas":{"Axis":{"properties":{"label":{"anyOf":[{"$ref":"#/components/schemas/AxisLabel"},{"type":"string"}],"title":"Label","description":"Quantity on the axis. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["I_D","R_DS_on"]},"unit":{"type":"string","title":"Unit","description":"Unit symbol of the axis values: an unprefixed SI unit, or °C or %.","examples":["A","Ω","%"]},"scale":{"anyOf":[{"$ref":"#/components/schemas/AxisScale"},{"type":"string"}],"title":"Scale","description":"Axis scale the datasheet draws. Extensible enum: new values may be added without a version change; handle unknown values."}},"type":"object","required":["label","unit","scale"],"title":"Axis","description":"Identity, unit and scale of one plot axis."},"AxisLabel":{"type":"string","enum":["I_D","V_DS","V_GS","Q_g","R_DS_on","V_bias","C_retention","f","Z","ESR","I_ripple","T_rise"],"title":"AxisLabel","description":"The quantity on a plot axis."},"AxisScale":{"type":"string","enum":["linear","log"],"title":"AxisScale"},"Capacitor":{"properties":{"part_number":{"type":"string","title":"Part Number","description":"The part number as requested.","examples":["C1206C475K5PACTU"]},"manufacturer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Manufacturer","examples":["Kemet"]},"family":{"anyOf":[{"$ref":"#/components/schemas/Family"},{"type":"string"}],"title":"Family","description":"The part's family: which kind of part it is. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["capacitor"]},"datasheet_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Datasheet Url","description":"The manufacturer's datasheet the values come from, where one exists."},"product_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Url","description":"The manufacturer's product page."},"package":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Package","description":"Package name or case code as the manufacturer gives it.","examples":["1206"]},"temperature_range":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Temperature Range","description":"Rated operating temperature range (°C) as the datasheet gives it, in min and max."},"qualifications":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Qualifications","description":"Reliability qualification standards the part meets, such as AEC-Q101, AEC-Q200 or MIL-PRF.","examples":[["AEC-Q200"]]},"environmental_status":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentalStatus"},{"type":"string"}]},"type":"array"},{"type":"null"}],"title":"Environmental Status","description":"Environmental compliance. Extensible enum: new values may be added without a version change; handle unknown values.","examples":[["rohs_compliant","halogen_free"]]},"product_status":{"anyOf":[{"$ref":"#/components/schemas/ProductStatus"},{"type":"string"},{"type":"null"}],"title":"Product Status","description":"Lifecycle status. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["active"]},"mounting_type":{"anyOf":[{"$ref":"#/components/schemas/MountingType"},{"type":"string"},{"type":"null"}],"title":"Mounting Type","description":"Mounting type. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["surface_mount"]},"technology":{"anyOf":[{"$ref":"#/components/schemas/CapacitorTechnology"},{"type":"string"},{"type":"null"}],"title":"Technology","description":"Capacitor technology. When the technology has fields of its own, an object with a name matching this value is included, such as `ceramic`. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["ceramic"]},"capacitance":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Capacitance","description":"Nominal capacitance (F)."},"voltage_rating":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Voltage Rating","description":"Rated voltage (V)."},"tolerance":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Tolerance","description":"Capacitance tolerance (%), symmetric about nominal."},"impedance":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Impedance","description":"Impedance against frequency."},"esr":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Esr","description":"Equivalent series resistance against frequency."},"ripple_current":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Ripple Current","description":"Temperature rise against ripple current, one curve per frequency."},"ceramic":{"$ref":"#/components/schemas/CeramicCapacitor","description":"Fields only ceramic parts have. Included when `technology` is `ceramic`, its fields `null` where unknown; left out of the response for every other technology."}},"type":"object","required":["part_number","manufacturer","family","datasheet_url","product_url","package","temperature_range","qualifications","environmental_status","product_status","mounting_type","technology","capacitance","voltage_rating","tolerance","impedance","esr","ripple_current"],"title":"Capacitor","description":"A capacitor's specs and vendor characterisation curves.\n\nThe sub-object named by `technology` is always present, its fields null\nwhere unknown; every other technology's sub-object is left out."},"CapacitorTechnology":{"type":"string","enum":["ceramic"],"title":"CapacitorTechnology"},"CeramicCapacitor":{"properties":{"dielectric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dielectric","description":"Dielectric code as the manufacturer gives it, such as `X7R` or `C0G`. Distributors often list it as the temperature coefficient.","examples":["X7R","C0G"]},"dc_bias":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Dc Bias","description":"Capacitance retained (% of nominal) against DC bias voltage."}},"type":"object","required":["dielectric","dc_bias"],"title":"CeramicCapacitor","description":"The fields only ceramic capacitors have."},"ChannelType":{"type":"string","enum":["n_channel","p_channel","n_channel_depletion"],"title":"ChannelType"},"Conditions":{"properties":{"V_GS":{"$ref":"#/components/schemas/Quantity","description":"Gate-source voltage (V)."},"I_D":{"$ref":"#/components/schemas/Quantity","description":"Drain current (A)."},"V_DS":{"$ref":"#/components/schemas/Quantity","description":"Drain-source voltage (V)."},"V_DD":{"anyOf":[{"$ref":"#/components/schemas/Quantity"},{"type":"null"}],"description":"Supply voltage a gate-charge curve was measured at (V); null when the curve doesn't state it."},"T_j":{"$ref":"#/components/schemas/Quantity","description":"Junction temperature (°C)."}},"type":"object","title":"Conditions","description":"Conditions keyed by quantity symbol. A key appears only when that\nquantity governs the value; `null` means it governs the value but the\ndatasheet doesn't state it."},"Current":{"properties":{"value":{"type":"number","exclusiveMinimum":0.0,"title":"Value","examples":[10]},"unit":{"type":"string","const":"A","title":"Unit","description":"Always A."}},"additionalProperties":false,"type":"object","required":["value","unit"],"title":"Current","description":"A current above 0 A, in amperes."},"Curve":{"properties":{"label":{"type":"string","title":"Label","description":"The curve's label as printed on the datasheet, such as the gate drive it was measured at. Empty when the plot has a single unlabelled curve.","examples":["10 V","f=10 kHz",""]},"points":{"items":{"items":{"type":"number"},"type":"array"},"type":"array","title":"Points","description":"[x, y] pairs in the axes' units, in the order the curve is drawn.","examples":[[[0.0,0.00087],[21.64,0.0009]]]}},"type":"object","required":["label","points"],"title":"Curve","description":"One labelled line of points on a plot."},"CurveReading":{"properties":{"quantity":{"$ref":"#/components/schemas/Quantity","description":"The typical value read, in unprefixed SI: Ω for R_DS(on), C for Q_g."},"plot":{"anyOf":[{"$ref":"#/components/schemas/PlotType"},{"type":"string"}],"title":"Plot","description":"The plot type the value was read from: the part's field of the same name holds it. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["rds_on_vs_id"]},"conditions":{"$ref":"#/components/schemas/Conditions","description":"The conditions the value was read at. On R_DS(on), check `V_GS`: when the datasheet doesn't print the requested drive, the value is read at the next printed drive down, a worst case, since R_DS(on) rises as V_GS falls."}},"type":"object","required":["quantity","plot","conditions"],"title":"CurveReading","description":"A typical value read off a datasheet curve, with the plot it came from\nand the conditions it was read at."},"EnvironmentalStatus":{"type":"string","enum":["rohs_compliant","halogen_free","lead_free","reach_compliant"],"title":"EnvironmentalStatus"},"Error":{"properties":{"code":{"anyOf":[{"$ref":"#/components/schemas/ErrorCode"},{"type":"string"}],"title":"Code","description":"Machine-readable reason. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["not_found"]},"message":{"type":"string","title":"Message","description":"Human-readable explanation."},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Param","description":"The query or path parameter that caused the error, when one did.","examples":["fields"]},"doc_url":{"type":"string","title":"Doc Url","description":"This code's entry on the Errors docs page.","examples":["https://www.get-merlin.com/docs/errors#not_found"]},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"This request's ID, the same as its `X-Request-Id` header. Quote it in a support request. Null on the errors the gateway sends itself: its per-IP 429, and a 502 or 504 when the Data API is down or doesn't answer in time."},"candidates":{"anyOf":[{"items":{"$ref":"#/components/schemas/PartRef"},"type":"array"},{"type":"null"}],"title":"Candidates","description":"Catalogue parts close to the one requested, when the request named no exact part. Each endpoint's 404 example shows its own family's."}},"type":"object","required":["code","message","param","doc_url","request_id","candidates"],"title":"Error","description":"What went wrong, for a program and for a person."},"ErrorCode":{"type":"string","enum":["unauthorized","forbidden","rate_limited","not_found","ambiguous_part","invalid_request","unavailable","internal_error"],"title":"ErrorCode","description":"Machine-readable reason for an error."},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"}},"type":"object","required":["error"],"title":"ErrorResponse","description":"The body of every v1 error response."},"Family":{"type":"string","enum":["mosfet","capacitor"],"title":"Family","description":"The part family: one kind of part, with one set of fields and its own\nendpoint."},"Mosfet":{"properties":{"part_number":{"type":"string","title":"Part Number","description":"The part number as requested.","examples":["ISCH42N04LM7"]},"manufacturer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Manufacturer","examples":["Infineon"]},"family":{"anyOf":[{"$ref":"#/components/schemas/Family"},{"type":"string"}],"title":"Family","description":"The part's family: which kind of part it is. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["mosfet"]},"datasheet_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Datasheet Url","description":"The manufacturer's datasheet the values come from, where one exists."},"product_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Url","description":"The manufacturer's product page."},"package":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Package","description":"Package name or case code as the manufacturer gives it.","examples":["PG-TDSON-8"]},"temperature_range":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Temperature Range","description":"Rated operating temperature range (°C) as the datasheet gives it, in min and max."},"qualifications":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Qualifications","description":"Reliability qualification standards the part meets, such as AEC-Q101, AEC-Q200 or MIL-PRF.","examples":[["AEC-Q101"]]},"environmental_status":{"anyOf":[{"items":{"anyOf":[{"$ref":"#/components/schemas/EnvironmentalStatus"},{"type":"string"}]},"type":"array"},{"type":"null"}],"title":"Environmental Status","description":"Environmental compliance. Extensible enum: new values may be added without a version change; handle unknown values.","examples":[["rohs_compliant","halogen_free"]]},"product_status":{"anyOf":[{"$ref":"#/components/schemas/ProductStatus"},{"type":"string"},{"type":"null"}],"title":"Product Status","description":"Lifecycle status. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["active"]},"mounting_type":{"anyOf":[{"$ref":"#/components/schemas/MountingType"},{"type":"string"},{"type":"null"}],"title":"Mounting Type","description":"Mounting type. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["surface_mount"]},"channel_type":{"anyOf":[{"$ref":"#/components/schemas/ChannelType"},{"type":"string"},{"type":"null"}],"title":"Channel Type","description":"Channel type. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["n_channel"]},"technology":{"anyOf":[{"$ref":"#/components/schemas/Technology"},{"type":"string"},{"type":"null"}],"title":"Technology","description":"Semiconductor material. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["si"]},"V_DS_abs_max":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"V Ds Abs Max","description":"Maximum drain-source voltage (V)."},"V_GS_abs_max":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"V Gs Abs Max","description":"Maximum gate-source voltage (V)."},"I_D_abs_max":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"I D Abs Max","description":"Maximum continuous drain current (A)."},"I_D_pulse_abs_max":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"I D Pulse Abs Max","description":"Maximum pulsed drain current (A)."},"E_AS":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"E As","description":"Single-pulse avalanche energy (J)."},"P_D_abs_max":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"P D Abs Max","description":"Maximum power dissipation (W)."},"R_DS_on":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"R Ds On","description":"Drain-source on-resistance (Ω)."},"V_GS_th":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"V Gs Th","description":"Gate threshold voltage (V)."},"I_DSS":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"I Dss","description":"Drain-source leakage current (A)."},"I_GSS":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"I Gss","description":"Gate-source leakage current (A)."},"R_G":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"R G","description":"Gate resistance (Ω)."},"g_fs":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"G Fs","description":"Forward transconductance (S)."},"C_iss":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"C Iss","description":"Input capacitance (F)."},"C_oss":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"C Oss","description":"Output capacitance (F)."},"C_rss":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"C Rss","description":"Reverse transfer capacitance (F)."},"t_d_on":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"T D On","description":"Turn-on delay time (s)."},"t_r":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"T R","description":"Rise time (s)."},"t_d_off":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"T D Off","description":"Turn-off delay time (s)."},"t_f":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"T F","description":"Fall time (s)."},"Q_gs":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Q Gs","description":"Gate-source charge (C)."},"Q_g_th":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Q G Th","description":"Gate charge at threshold (C)."},"Q_gd":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Q Gd","description":"Gate-drain (Miller) charge (C)."},"Q_sw":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Q Sw","description":"Switching charge (C)."},"Q_g":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Q G","description":"Total gate charge (C)."},"V_plateau":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"V Plateau","description":"Gate plateau voltage (V)."},"Q_oss":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Q Oss","description":"Output charge (C)."},"R_th_JA":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"R Th Ja","description":"Junction-to-ambient thermal resistance (°C/W)."},"R_th_JC_top":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"R Th Jc Top","description":"Junction-to-case (top) thermal resistance (°C/W)."},"R_th_JC_bot":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"R Th Jc Bot","description":"Junction-to-case (bottom) thermal resistance (°C/W)."},"I_S":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"I S","description":"Continuous body diode current (A)."},"I_S_pulse":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"I S Pulse","description":"Pulsed body diode current (A)."},"V_SD":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"V Sd","description":"Body diode forward voltage (V)."},"t_rr":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"T Rr","description":"Body diode reverse recovery time (s)."},"Q_rr":{"anyOf":[{"items":{"$ref":"#/components/schemas/Spec"},"type":"array"},{"type":"null"}],"title":"Q Rr","description":"Body diode reverse recovery charge (C)."},"gate_charge":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Gate Charge","description":"Gate-source voltage against gate charge, one curve per supply voltage."},"safe_operating_area":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Safe Operating Area","description":"Safe operating area, drain current against drain-source voltage, one curve per pulse width."},"rds_on_vs_id":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Rds On Vs Id","description":"On-resistance against drain current, one curve per gate drive."},"output_characteristics":{"anyOf":[{"items":{"$ref":"#/components/schemas/Plot"},"type":"array"},{"type":"null"}],"title":"Output Characteristics","description":"Drain current against drain-source voltage, one curve per gate drive."}},"type":"object","required":["part_number","manufacturer","family","datasheet_url","product_url","package","temperature_range","qualifications","environmental_status","product_status","mounting_type","channel_type","technology","V_DS_abs_max","V_GS_abs_max","I_D_abs_max","I_D_pulse_abs_max","E_AS","P_D_abs_max","R_DS_on","V_GS_th","I_DSS","I_GSS","R_G","g_fs","C_iss","C_oss","C_rss","t_d_on","t_r","t_d_off","t_f","Q_gs","Q_g_th","Q_gd","Q_sw","Q_g","V_plateau","Q_oss","R_th_JA","R_th_JC_top","R_th_JC_bot","I_S","I_S_pulse","V_SD","t_rr","Q_rr","gate_charge","safe_operating_area","rds_on_vs_id","output_characteristics"],"title":"Mosfet","description":"A MOSFET's datasheet specs and extracted curves.\n\nIts technologies share every field, so it has no technology sub-object."},"MosfetFilters":{"properties":{"manufacturer":{"anyOf":[{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":50,"minItems":1},{"type":"null"}],"title":"Manufacturer","description":"Any of these manufacturers, ignoring case.","examples":[["Infineon"]]},"package":{"anyOf":[{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":50,"minItems":1},{"type":"null"}],"title":"Package","description":"Any of these packages, ignoring case.","examples":[["PG-TSON-8"]]},"V_DS_abs_max":{"anyOf":[{"$ref":"#/components/schemas/VoltageRange"},{"type":"null"}],"description":"Drain-source voltage rating (V), as the datasheet states it."},"qualifications":{"anyOf":[{"items":{"type":"string","maxLength":100,"minLength":1},"type":"array","maxItems":50,"minItems":1},{"type":"null"}],"title":"Qualifications","description":"Every one of these qualifications, ignoring case: a part matches only if it holds all of them.","examples":[["AEC-Q101"]]}},"additionalProperties":false,"type":"object","title":"MosfetFilters","description":"Filters on MOSFETs."},"MosfetTradeoffRequest":{"properties":{"filters":{"$ref":"#/components/schemas/MosfetFilters","description":"Which MOSFETs to compare. Send at least one filter: without one the request would compare the whole catalogue."},"operating_point":{"$ref":"#/components/schemas/TradeoffOperatingPoint"}},"additionalProperties":false,"type":"object","required":["filters","operating_point"],"title":"MosfetTradeoffRequest","description":"N-channel MOSFETs to compare, and the operating point to compare them at."},"MosfetTradeoffs":{"properties":{"operating_point":{"$ref":"#/components/schemas/Conditions","description":"The request's operating point, unchanged."},"axes":{"items":{"anyOf":[{"$ref":"#/components/schemas/TradeoffAxis"},{"type":"string"}]},"type":"array","title":"Axes","description":"The ranked axes, each a key of every point's `values`. Extensible enum: new values may be added without a version change; handle unknown values.","examples":[["R_DS_on","Q_g"]]},"excluded":{"items":{"$ref":"#/components/schemas/TradeoffExclusion"},"type":"array","title":"Excluded","description":"Matching parts that have no point, by reason. The parts that matched the filters are `data` plus these."},"data":{"items":{"$ref":"#/components/schemas/TradeoffPoint"},"type":"array","title":"Data","description":"One point per orderable part. The whole set comes in one response, since a rank only means something across all of it."}},"type":"object","required":["operating_point","axes","excluded","data"],"title":"MosfetTradeoffs","description":"Every matching MOSFET's R_DS(on) and Q_g at the operating point, with\nits Pareto rank: front first, then by rank and R_DS(on)."},"MountingType":{"type":"string","enum":["surface_mount","through_hole","chassis_mount"],"title":"MountingType"},"PartRef":{"properties":{"part_number":{"type":"string","title":"Part Number","description":"The catalogue part number.","examples":["ISCH42N04LM7"]},"manufacturer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Manufacturer","examples":["Infineon"]},"family":{"anyOf":[{"$ref":"#/components/schemas/Family"},{"type":"string"}],"title":"Family","description":"The part's family. Extensible enum: new values may be added without a version change; handle unknown values.","examples":["mosfet"]},"url":{"type":"string","title":"Url","description":"The part's own endpoint: GET it, with your API key, for the whole part.","examples":["https://api.get-merlin.com/v1/mosfets/ISCH42N04LM7"]}},"type":"object","required":["part_number","manufacturer","family","url"],"title":"PartRef","description":"A pointer to one catalogue part, wherever a response names a part\nwithout returning it. `url` serves the whole part."},"Plot":{"properties":{"plot_type":{"anyOf":[{"$ref":"#/components/schemas/PlotType"},{"type":"string"}],"title":"Plot Type","description":"Which kind of plot this is; matches the field it appears under. Extensible enum: new values may be added without a version change; handle unknown values."},"x":{"$ref":"#/components/schemas/Axis"},"y":{"$ref":"#/components/schemas/Axis"},"conditions_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conditions Text","description":"Conditions printed for the whole plot, such as the junction temperature.","examples":["Tj=25 °C"]},"curves":{"items":{"$ref":"#/components/schemas/Curve"},"type":"array","title":"Curves"}},"type":"object","required":["plot_type","x","y","conditions_text","curves"],"title":"Plot","description":"A datasheet plot as data: its axes, conditions and curves."},"PlotType":{"type":"string","enum":["rds_on_vs_id","gate_charge","output_characteristics","safe_operating_area","dc_bias","impedance","esr","ripple_current"],"title":"PlotType","description":"Which kind of plot this is; matches the field it appears under."},"ProductStatus":{"type":"string","enum":["active","last_time_buy","not_for_new_designs","obsolete"],"title":"ProductStatus"},"Quantity":{"properties":{"value":{"type":"number","title":"Value","examples":[10]},"unit":{"type":"string","title":"Unit","description":"Unit symbol of `value`, such as V, A or °C.","examples":["V"]}},"type":"object","required":["value","unit"],"title":"Quantity","description":"A number and its unit, unprefixed SI (°C excepted), such as a test\ncondition or a value read off a curve."},"Spec":{"properties":{"min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min","description":"Minimum value."},"typ":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Typ","description":"Typical value."},"max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max","description":"Maximum value."},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit","description":"Unit symbol: an unprefixed SI unit, or °C or %. Values are never prefixed: 0.00039 Ω, not 0.39 mΩ.","examples":["V","A","Ω","F","C","s","°C","%"]},"conditions_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conditions Text","description":"Test conditions as printed on the datasheet.","examples":["VGS=10V, ID=50A"]}},"type":"object","required":["min","typ","max","unit","conditions_text"],"title":"Spec","description":"One datasheet reading of a quantity, in unprefixed SI units (°C and %\nexcepted)."},"Technology":{"type":"string","enum":["si","sic"],"title":"Technology"},"TradeoffAxis":{"type":"string","enum":["R_DS_on","Q_g"],"title":"TradeoffAxis","description":"A quantity a trade-off ranks on; the key of its value in `values`."},"TradeoffExclusion":{"properties":{"reason":{"anyOf":[{"$ref":"#/components/schemas/TradeoffExclusionReason"},{"type":"string"}],"title":"Reason","description":"Why the parts weren't placed. Each part counts under the first reason that applies, in this order: at_or_below_miller_plateau, no_r_ds_on_curve, no_drive_at_or_below, no_reading_at_i_d, no_gate_charge_curve, gate_charge_short_of_v_gs. Extensible enum: new values may be added without a version change; handle unknown values."},"count":{"type":"integer","title":"Count","description":"Orderable parts excluded for this reason."}},"type":"object","required":["reason","count"],"title":"TradeoffExclusion"},"TradeoffExclusionReason":{"type":"string","enum":["at_or_below_miller_plateau","no_r_ds_on_curve","no_drive_at_or_below","no_reading_at_i_d","no_gate_charge_curve","gate_charge_short_of_v_gs"],"title":"TradeoffExclusionReason","description":"Why a part that matched the filters has no point."},"TradeoffOperatingPoint":{"properties":{"V_GS":{"$ref":"#/components/schemas/Voltage","description":"Gate drive. R_DS(on) is read on the highest drive the datasheet prints at or below it; Q_g at this drive itself. A part whose Miller plateau is at or above it is excluded."},"I_D":{"$ref":"#/components/schemas/Current","description":"Drain current R_DS(on) is read at."},"V_DS":{"$ref":"#/components/schemas/Voltage","description":"Drain-source voltage in the off state, such as a buck's input. Picks the gate-charge curve whose V_DD is nearest."}},"additionalProperties":false,"type":"object","required":["V_GS","I_D","V_DS"],"title":"TradeoffOperatingPoint","description":"The conditions every candidate is read at: exactly `V_GS`, `I_D` and\n`V_DS`, each with its unit and above zero. Any other key is refused. A\nvalue beyond what a part's curves cover isn't refused: that part is\ncounted under `excluded`. Every value is read at a junction temperature\nof 25 °C."},"TradeoffPoint":{"properties":{"part":{"$ref":"#/components/schemas/PartRef","description":"The part; `GET` its `url` for all of it."},"rank":{"type":"integer","title":"Rank","description":"Pareto rank on the ranked axes, all minimized: 0 is the front, where no other point is at least as good on every axis and better on one; removing it leaves rank 1's front, and so on. Parts with identical values, such as a part and its tape-and-reel variant, share a rank.","examples":[0]},"values":{"$ref":"#/components/schemas/TradeoffValues"}},"type":"object","required":["part","rank","values"],"title":"TradeoffPoint","description":"One orderable part's values and its rank."},"TradeoffValues":{"properties":{"R_DS_on":{"$ref":"#/components/schemas/CurveReading"},"Q_g":{"$ref":"#/components/schemas/CurveReading"}},"type":"object","required":["R_DS_on","Q_g"],"title":"TradeoffValues","description":"The ranked axes' values, keyed by MOSFET field name."},"Voltage":{"properties":{"value":{"type":"number","exclusiveMinimum":0.0,"title":"Value","examples":[10]},"unit":{"type":"string","const":"V","title":"Unit","description":"Always V."}},"additionalProperties":false,"type":"object","required":["value","unit"],"title":"Voltage","description":"A voltage above 0 V, in volts."},"VoltageRange":{"properties":{"min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min","description":"Lowest value, inclusive (V).","examples":[30]},"max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max","description":"Highest value, inclusive (V); at least `min`.","examples":[50]}},"additionalProperties":false,"type":"object","title":"VoltageRange","description":"An inclusive range in volts. A range no part falls in matches nothing,\nrather than being refused."}},"securitySchemes":{"ApiKey":{"type":"http","description":"A Merlin Data API key, sent as `Authorization: Bearer <key>`.","scheme":"bearer"}}},"tags":[{"name":"mosfets","description":"Power MOSFETs: datasheet specs and extracted curves.","x-displayName":"MOSFETs"},{"name":"capacitors","description":"Capacitors: specs and vendor curves.","x-displayName":"Capacitors"}]}