Home
GET/signing_key
This method returns the Public Key, Public Key as JWE, and metadata for all keypairs associated with the application key making the call.
Note: It is important to note that privateKey
values are not returned. In order to further ensure the security of confidential client information, eBay does not store privateKey
values in any system. If a developer loses their privateKey
they must generate new keypairs set using the createSigningKey
method.
This method is supported in Sandbox environment. To access the endpoint, just replace the apiz.ebay.com
root URI with apiz.sandbox.ebay.com
This method has no URI parameters.
All requests made to eBay REST operations require you to provide the Authorization
HTTP header for authentication authorization.
All other standard RESTful request headers are optional. For more information on standard RESTful request headers, see the HTTP request headers- opens rest request components page table.
This request requires an access token created with the client credentials grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):
https://api.ebay.com/oauth/api_scope
See OAuth access tokens for more information.
This call has no payload.
This call has no field definitions.
This call has no response headers.
Output container/field | Type | Description |
---|---|---|
signingKeys | array of SigningKey | An array of metadata information for keypairs owned by a user. Occurrence: Conditional |
signingKeys.creationTime | integer | The UNIX timestamp when the Occurrence: Always |
signingKeys.expirationTime | integer | The UNIX timestamp when the Occurrence: Always |
signingKeys.jwe | string | This is the JSON Web Encrypted (JWE) value for the Occurrence: Always |
signingKeys.privateKey | string | This is the Private Key that has been generated using the specified Occurrence: Conditional |
signingKeys.publicKey | string | This is the Public Key that has been generated using the specified Occurrence: Always |
signingKeys.signingKeyCipher | SigningKeyCipher | Indicates the cipher used to create the keypairs. Refer to SigningKeyCiper for the list of supported enum values. Occurrence: Always |
signingKeys.signingKeyId | string | The system-generated eBay ID for the keypairs. Occurrence: Always |
This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.
Status | Meaning |
---|---|
200 | OK |
401 | Unauthorized |
403 | Forbidden |
500 | Internal Server Error |
For more on errors, plus the codes of other common errors, see Handling errors.
Code | Domain | Category | Meaning |
---|---|---|---|
210000 | API_KEYS | APPLICATION | There was a problem with an eBay internal system or process. Contact eBay developer support for assistance. |
210005 | API_KEYS | REQUEST | You must request with a token having valid application client id. |
This call has no warnings.
New to making API calls? Please see Making a Call.
Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.
This sample returns the Public Key, Public Key as JWE, and metadata for all keypairs associated with the application key making the call.
Note: It is important to note that Private Key values are not returned. In order to further ensure the security of confidential client information, eBay does not store any Private Key value in any system. If a developer loses their Private Key they must generate new keypairs using the createSigningKey
method.
There is no request payload for this method.
GEThttps://api.ebay.com/developer/key_management/v1/signing_key
A successful call returns the HTTP status code 200 OK.
The response payload includes the the Public Key, Public Key as JWE, and metadata for all keypairs associated with the application key making the call.