Home
EN
Location
Documentation Home
Palo Alto Networks
Support
Live Community
Knowledge Base
>
Clear
PAN-OS XML API Error Codes
Updated on
Thu Aug 28 13:33:18 PDT 2025
Focus
Download PDF
Updated on
Thu Aug 28 13:33:18 PDT 2025
Focus
Home
Next-Generation Firewall
Getting Started with the PAN-OS XML API
PAN-OS XML API Error Codes
Download PDF
Next-Generation Firewall
PAN-OS XML API Error Codes
Table of Contents
Filter
Expand All
|
Collapse All
Next-Generation Firewall Docs
Getting Started
Administration
Networking
Quick Start
Reference
Incidents & Alerts
Release Notes
Select a Document
PAN-OS 12.1
PAN-OS 11.2
PAN-OS 11.1
PAN-OS 11.0 (EoL)
PAN-OS 10.2
PAN-OS 10.1
PAN-OS 10.0 (EoL)
PAN-OS 9.1 (EoL)
PAN-OS 9.0 (EoL)
PAN-OS 8.1 (EoL)
Help
Select a Document
PAN-OS 12.1
PAN-OS 11.2
PAN-OS 11.1
PAN-OS 10.2
PAN-OS 10.1
Previous
Structure of a PAN-OS XML API Request
Next
XPath Node Selection
PAN-OS XML API Error Codes
The API response XML contains a status field and an error field. These are the available API error codes and names:
Error Code
Name
Description
400
Bad request
A required parameter is missing, an illegal parameter value is used.
403
Forbidden
Authentication or authorization errors including invalid key or insufficient admin access rights. Learn how to
Generate an API Key Certificate
.
1
Unknown command
The specific config or operational command is not recognized.
2-5
Internal errors
Check with technical support when seeing these errors.
6
Bad Xpath
The xpath specified in one or more attributes of the command is invalid. Check the API browser for proper xpath values.
7
Object not present
Object specified by the xpath is not present. For example, entry[@name='value'] where no object with name 'value' is present.
8
Object not unique
For commands that operate on a single object, the specified object is not unique.
10
Reference count not zero
Object cannot be deleted as there are other objects that refer to it. For example, address object still in use in policy.
11
Internal error
Check with technical support when seeing these errors.
12
Invalid object
Xpath or element values provided are not complete.
13
Object not found
Object presented in the request could not be found.
14
Operation not possible
Operation is allowed but not possible in this case. For example, moving a rule up one position when it is already at the top.
15
Operation denied
Operation is allowed. For example, Admin not allowed to delete own account, Running a command that is not allowed on a passive device.
16
Unauthorized
The API role does not have access rights to run this query.
17
Invalid command
Invalid command or parameters.
18
Malformed command
The XML is malformed.
19-20
Success
Command completed successfully.
21
Internal error
Check with technical support when seeing these errors.
22
Session timed out
The session for this query timed out.
Previous
Structure of a PAN-OS XML API Request
Next
XPath Node Selection