OpenAPI
OpenAPI Version: 3.0.0
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
OpenAPI Version: 3.0.0
Version: '1.0.0'
Title: '5G-EIR Equipment Identity Check'
Description: '5G-EIR Equipment Identity Check Service'
URL: '{apiRoot}/n5g-eir-eic/v1'
Variables:
API Root:
Default: https://example.com
Description: apiRoot as defined in subclause subclause 4.4 of 3GPP TS 29.501
- {}
- oAuth2ClientCredentials:
- n5g-eir-eic
get:
Summary: Retrieves the status of the UE
Operation ID: GetEquipmentStatus
Tags:
- Equipment Status (Document)
Parameters:
- Name: pei
In: query
Description: PEI of the UE
Required/Optional: true
Schema:
Reference: '#/components/schemas/Pei'
- Name: supi
In: query
Description: SUPI of the UE
Required/Optional: false
Schema:
Reference: '#/components/schemas/Supi'
Responses:
'200':
Description: Expected response to a valid request
Content:
Application/JSON:
Schema:
Reference: '#/components/schemas/EirResponseData'
'400':
Reference: 'TS29571_CommonData.yaml#/components/responses/400'
'401':
Reference: 'TS29571_CommonData.yaml#/components/responses/401'
'404':
Description: PEI Not Found
Content:
application/problem+json:
Schema:
Reference: '#/components/schemas/ProblemDetails'
'414':
Reference: 'TS29571_CommonData.yaml#/components/responses/414'
'429':
Reference: 'TS29571_CommonData.yaml#/components/responses/429'
'500':
Reference: 'TS29571_CommonData.yaml#/components/responses/500'
'503':
Reference: 'TS29571_CommonData.yaml#/components/responses/503'
Default:
Description: Unexpected error
Content:
application/problem+json:
Schema:
Reference: '#/components/schemas/ProblemDetails'
securitySchemes:
oAuth2ClientCredentials:
Type: oauth2
Flows:
clientCredentials:
tokenUrl: '{nrfApiRoot}/oauth2/token'
scopes:
n5g-eir-eic: Access to the N5g-eir_EquipmentIdentityCheck API
schemas:
EirResponseData:
Type: object
Required:
- status
Properties:
status:
Reference: '#/components/schemas/EquipmentStatus'
Pei:
Type: string
Pattern: "([0-9]{14})"
Supi:
Type: string
Pattern: "(imsi-[0-9]{5,15}|nai-.+)"
EquipmentStatus:
Type: string
enum:
- WHITELISTED
- BLACKLISTED
- GREYLISTED
ProblemDetails:
Description: 'https://www.rfc-editor.org/rfc/rfc7807.txt'
Type: object
Required:
- type
Properties:
Type:
Type: string
title:
Type: string
status:
Type: integer
detail:
Type: string
instance:
Type: string
Description: 3GPP TS 29.511 V15.2.0; 5G System; Equipment Identity Register Services; Stage 3
URL: 'http://www.3gpp.org/ftp/Specs/archive/29_series/29.511/'