{"type":"api","title":"Get Service Provider","meta":{"id":"/apps/pubhub/media/legacy-umbrella-api/bf58de618cbb72dda8f39b0414ce94c0a15cd467/749b3a73-c1a2-3c03-8a59-0be6ab11a602","swagger":"2.0","info":{"title":"Service Providers","version":"1.0.0","description":"Service Providers and Managed Service Providers (MSPs)","contact":{"name":"Cloud Security Developer Community"}},"host":"management.api.umbrella.com","basePath":"/v1","schemes":["https"],"securityDefinitions":{"http":{"type":"basic"}},"security":[{"http":[]}],"x-parser-conf":{"httpBasic":{"username":"","password":""},"overview":{"markdownPath":"legacy/management/service-providers-overview.md"},"meta":{"useProxy":true}}},"spec":{"tags":["Service Providers"],"description":"Get a service provider","summary":"Get Service Provider","operationId":"getServiceProvider","parameters":[{"name":"serviceProviderId","type":"integer","description":"The ID of the service provider","in":"path","required":true,"$$ref":"#/parameters/serviceProviderIdParam"}],"responses":{"200":{"description":"Get a service provider","schema":{"properties":{"packageName":{"type":"string","description":"The name of the service provider's subscribed package"},"seatsTotal":{"type":"integer","description":"The number of seats that are allocated to the service provider"},"seatsUsed":{"type":"integer","description":"The number of seats used by the service provider"},"customerCount":{"type":"integer","description":"The number of customers for the service provider"},"status":{"type":"string","description":"The status of the service provider"},"rebillAt":{"type":"string","format":"date-time","description":"The time when the service provider was rebilled.\nSpecified as an ISO 8601 timestamp."},"expiresAt":{"type":"string","format":"date-time","description":"The time when the service provider's subscription expires.\nSpecified as an ISO 8601 timestamp."}},"type":"object","required":["packageName","seatsTotal","seatsUsed","customerCount","status","rebillAt","expiresAt"],"example":{"packageName":"Umbrella SIG Essentials","seatsTotal":25,"seatsUsed":20,"customerCount":20,"status":"enrolled","rebillAt":"2022-06-13T16:07:07.222Z","expiresAt":"2022-06-13T16:07:07.222Z"}}},"400":{"description":"Bad Request","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":400,"description":"the http error code returned"},"error":{"type":"string","example":"Validation Error","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"},"validationErrors":{"type":"object","properties":{"someProperty":{"type":"string","example":"must not be empty","description":"the name of the property failing validation."}}}}},"$$ref":"#/responses/BadRequest"},"401":{"description":"Unauthorized","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":401,"description":"The authorization header is missing or the token is unauthorized"},"error":{"type":"string","example":"Unauthorized","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/Unauthorized"},"403":{"description":"Forbidden","schema":{"type":"object","minProperties":1,"required":["message"],"properties":{"statusCode":{"type":"integer","example":403,"description":"the http error code returned"},"error":{"type":"string","example":"Forbidden, Invalid authentication credentials","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/Forbidden"},"404":{"description":"Not Found","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":404,"description":"the http error code returned"},"error":{"type":"string","example":"Not Found","description":"A resource that is specified in the URL was not found."},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/NotFound"},"500":{"description":"Internal Server Error","schema":{"type":"object","minProperties":3,"required":["statusCode","error","txId"],"properties":{"statusCode":{"type":"integer","example":500,"description":"the http error code returned"},"error":{"type":"string","example":"Internal Server Error","description":"a brief description of the error"},"txId":{"type":"string","example":"86e189a6-0124-47d3-a32c-25ff3f07deaf","description":"a unique hex number that can be used for debugging"}}},"$$ref":"#/responses/ServerError"}},"__originalOperationId":"getServiceProvider","consumes":["application/json"],"produces":["application/json"],"security":[{"http":[]}],"method":"get","path":"/serviceproviders/{serviceProviderId}"}}